واجهة بايثون
كيف تُصدر أداتك خطة يعاينها 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.