أداة سطر أوامر لتنظيم الملفات بلغة Python

Python Development Lab

مختبر تطوير Pythonالمستوى: مبتدئ المدة: ساعة واحدة

وصف المشروع

مشروع قصير يعلّم العمل مع وكيل برمجة على مشروع Python صغير: الوصف، ثم التنفيذ، ثم الاختبارات.

الأدوات المستخدمة

يمكن استبدال الوكيل بأي وكيل برمجة مشابه؛ الخطوات مكتوبة بحيث لا تعتمد على أداة واحدة.

المتطلبات

  • Python 3.10 أو أحدث
  • pytest

خطوات التنفيذ

  1. وصف المهمة للوكيل

    ابدأ بوصف دقيق للمدخلات والمخرجات والقيود.

    Prompt لهذه الخطوة
    أنشئ أداة سطر أوامر بلغة Python باسم organize.py ...
  2. التنفيذ والمراجعة

    راجع الفروقات قبل قبولها، وتأكد من عدم استخدام مكتبات خارجية.

  3. الاختبارات

    اطلب اختبارات تستخدم tmp_path حتى لا تمس ملفاتك.

    Prompt لهذه الخطوة
    اكتب اختبارات pytest ...
    كود / أوامر
    pytest -q

Prompts جاهزة

توليد الأداة
أنشئ أداة سطر أوامر بلغة Python باسم organize.py تنقل الملفات في مجلد إلى مجلدات فرعية حسب الامتداد. أضف الخيار --dry-run لعرض ما سيحدث دون نقل، واستخدم pathlib وargparse فقط.
الاختبارات
اكتب اختبارات pytest لـ organize.py تستخدم tmp_path، وتتحقق من وضع dry-run ومن الملفات بلا امتداد.

مثال من الكود الناتج

from pathlib import Path
import argparse, shutil

def organize(folder: Path, dry_run: bool = False) -> list[tuple[Path, Path]]:
    moves = []
    for f in folder.iterdir():
        if f.is_file():
            ext = f.suffix.lower().lstrip(".") or "no_ext"
            target = folder / ext / f.name
            moves.append((f, target))
            if not dry_run:
                target.parent.mkdir(exist_ok=True)
                shutil.move(str(f), target)
    return moves

if __name__ == "__main__":
    p = argparse.ArgumentParser()
    p.add_argument("folder", type=Path)
    p.add_argument("--dry-run", action="store_true")
    a = p.parse_args()
    for src, dst in organize(a.folder, a.dry_run):
        print(f"{src.name} -> {dst.parent.name}/")

مثال توضيحي لما يُتوقع أن ينتجه الوكيل؛ قد يختلف الناتج الفعلي، فراجعه واختبره دائماً.

الاختبارات

  • pytest -q
  • تشغيل الأداة بـ --dry-run على مجلد تجريبي

النتائج المتوقعة

  • نقل الملفات إلى مجلدات حسب الامتداد
  • عدم تغيير أي ملف في وضع dry-run

الأخطاء الشائعة وحلولها

الخطأالحل
نقل ملفات إلى مجلد داخل المجلد نفسه أثناء التكراراجمع قائمة الملفات أولاً ثم انقلها

روابط الوثائق