ورّاق

الرئيسية planfs

واجهة بايثون

كيف تُصدر أداتك خطة يعاينها planfs، وكيف تفحصها وتنفذها من بايثون.

import planfs

plan = planfs.Plan("dedupe-2026")
plan.move("وارد/تاريخ بغداد.pdf", "التاريخ/تاريخ بغداد - الخطيب البغدادي.pdf", reason="مطابق للفهرس")
plan.delete("وارد/تاريخ بغداد (1).pdf", reason="نسخة مطابقة")
plan.save("plans/dedupe.tsv")        # يراجعها الإنسان: planfs plans/dedupe.tsv

with planfs.open_target("rclone:nas:Books") as storage:
    sim = planfs.check(plan, storage)    # الفحوص نفسها، ولا يتغير شيء
    for step in sim.blocked:
        print(step.op.src, step.errors[0])
    print(sim.to_dict()["counts"])
  • planfs.check يعيد نتيجة لكل سطر: الحالة، والمسار الحقيقي على التخزين، والأخطاء والتنبيهات برموز ثابتة (target-exists، nfc-collision، name-rule …).
  • planfs.apply(plan, storage, journal="changes.jsonl") ينفّذ دون سؤال؛ فالسؤال من شأن الأداة التي تستدعيه.
  • planfs.undo("dedupe-2026", storage, journal="changes.jsonl") يتراجع.

والأفضل لأداة تقترح تغييرات أن تكتب الخطة وتترك التنفيذ للإنسان بأمر planfs apply.

حرّر هذه الصفحة