أداة سطر أوامر لتنظيم الملفات بلغة Python
Python Development Lab
وصف المشروع
مشروع قصير يعلّم العمل مع وكيل برمجة على مشروع Python صغير: الوصف، ثم التنفيذ، ثم الاختبارات.
الأدوات المستخدمة
يمكن استبدال الوكيل بأي وكيل برمجة مشابه؛ الخطوات مكتوبة بحيث لا تعتمد على أداة واحدة.
المتطلبات
- Python 3.10 أو أحدث
- pytest
خطوات التنفيذ
وصف المهمة للوكيل
ابدأ بوصف دقيق للمدخلات والمخرجات والقيود.
Prompt لهذه الخطوةأنشئ أداة سطر أوامر بلغة Python باسم organize.py ...التنفيذ والمراجعة
راجع الفروقات قبل قبولها، وتأكد من عدم استخدام مكتبات خارجية.
الاختبارات
اطلب اختبارات تستخدم 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
الأخطاء الشائعة وحلولها
| الخطأ | الحل |
|---|---|
| نقل ملفات إلى مجلد داخل المجلد نفسه أثناء التكرار | اجمع قائمة الملفات أولاً ثم انقلها |
