شارك المقالة
إعادة تسمية ملفات متعددة بأرقام متسلسلة في Python

إعادة تسمية ملفات متعددة بأرقام متسلسلة في Python

سكريبت لإعادة تسمية ملفات متعددة في Python بأرقام متسلسلة مع الحفاظ على الامتداد، ومعاينة مسبقة ومنع التصادم وسجل للأسماء الأصلية.

إعادة تسمية ملفات متعددة في Python يمكن أن تنظم مجموعة صور أو مستندات إلى item_001.jpg وitem_002.pdf وما بعدها. يحافظ المثال على امتداد كل ملف ويضيف رقمًا بصفر بادئ لتبقى الأسماء مرتبة نصيًا لعدد مناسب من العناصر. لا يضيف مسافة بين الرقم والامتداد كما كان يحدث في المثال القديم، ولا يعتمد ترتيب os.listdir غير المحدد. يعرض الخطة أولًا، ولا ينفذ التغييرات إلا مع –apply.

أوامر التجهيز والتشغيل

python number_files.py demo-files
# Apply only to a reviewed test folder:
python number_files.py demo-files --apply --log rename-numbered.jsonl

استخدام المحرك المشترك في درس توحيد الأسماء

انسخ safe_rename.py من درس تحويل أسماء الملفات إلى حروف صغيرة، ثم ضع number_files.py المعروض هنا بجواره في مجلد أدوات خارج البيانات. يحتوي المحرك دوال build_plan وnumbered_name وapply_plan، بينما يحدد الملف الصغير طريقة التشغيل فقط. بهذه البنية تتشارك طريقتا التسمية فحص التصادم والسجل بدل صيانة نسختين مختلفتين. إذا ظهر ModuleNotFoundError فراجع اسم الملف ومكانه، ولا تثبت حزمة عشوائية باسم safe_rename من الإنترنت.

كيف يُحدد ترتيب الأرقام؟

يرتب المحرك العناصر حسب الاسم بمقارنة غير حساسة نسبيًا لحالة الحروف، مع الاسم الأصلي لكسر التعادل. ثم يرقم الملفات العادية غير المخفية الموجودة مباشرة داخل المجلد. هذا ترتيب أسماء وليس ترتيب تاريخ التصوير أو وقت الإنشاء؛ إذا احتجت تسلسلًا زمنيًا فحدد مصدر التاريخ وغيّر سياسة الفرز قبل بناء الخطة. المجلدات والروابط الرمزية تبقى كما هي، ولا يبحث البرنامج في المجلدات الفرعية تلقائيًا.

الكود: number_files.py

import argparse
from safe_rename import build_plan, numbered_name, apply_plan

if __name__ == "__main__":
    parser = argparse.ArgumentParser()
    parser.add_argument("folder")
    parser.add_argument("--apply", action="store_true")
    parser.add_argument("--log", default="rename-numbered.jsonl")
    args = parser.parse_args()
    plan = build_plan(args.folder, numbered_name)
    for source, target in plan:
        print(source.name, "->", target.name)
    if args.apply:
        apply_plan(plan, args.log)
    else:
        print("Preview only; no files changed")

الحفاظ على الامتداد ومعنى الاسم الجديد

تنتج numbered_name اسمًا مكونًا من item ورقم وثلاث خانات كحد أدنى ثم الامتداد بحروف صغيرة. بعد 999 لا تُحذف الأرقام الزائدة، لكن المقارنة النصية بين أحجام أرقام مختلفة قد لا تعطي الترتيب الذي تتوقعه؛ اختر عرضًا مناسبًا لعدد ملفاتك. الاسم لا يعيد ترميز الصورة ولا يحول PDF إلى نوع آخر. أما الامتدادات المركبة فتحتاج سياسة إضافية إذا أردت الاحتفاظ بها كاملة بدل suffix الأخير.

منع الاستبدال وحفظ السجل

لا يكفي فحص exists ثم استدعاء rename، لأن العملية قد تستبدل هدفًا على نظام وتفشل على آخر. يستخدم المحرك أسماء مؤقتة ونقلًا يرفض الهدف الموجود، ويعالج الأهداف المتكررة بلاحقة. تحفظ الخطة ومسارات النقل في ملف JSONL جديد خارج مجلد البيانات. إذا حدث فشل في مرحلة لاحقة فقد تبقى أسماء مؤقتة؛ لا تمسحها لأنها ما زالت الملفات نفسها. راجع السجل وخذ نسخة من المجلد قبل أي محاولة استعادة.

تجربة عملية صغيرة قبل الصور الأصلية

جهز demo-files بثلاث نسخ ملفات لها امتدادات مختلفة. نفذ أمر المعاينة وتأكد من عدد العمليات ومن أن كل مسار داخل المجلد المقصود. بعد التطبيق افحص المحتوى وأحجام الملفات، وراجع أسطر completed في السجل. جرب اسم هدف يشبه مجلدًا موجودًا وتأكد من أن المجلد لا يتغير. أوقف أي مزامنة أو عملية كتابة موازية أثناء التجربة؛ البرنامج التعليمي لا يقفل المجلد ضد جميع تغييرات التطبيقات الأخرى.

هل يمكن التراجع عن الترقيم؟

الأسماء الأصلية ليست قابلة للاستنتاج من أرقام فقط، لذلك السجل والنسخة الاحتياطية ضروريان. الاستعادة تحتاج مطابقة كل مسار حالي بآخر مرحلة مكتملة ثم التأكد أن الاسم الأصلي متاح قبل نقله. لا تطبق كل أسطر planned بالعكس دون فحص، لأن بعضها قد لم يُنفذ أصلًا. إذا أردت اسمًا وصفيًا مع الرقم، عدل numbered_name وأعد المعاينة على نسخ جديدة. لا تعاود الترقيم في كل تشغيل تلقائيًا داخل مشروع يعتمد روابط الملفات.

هل الترتيب الرقمي ثابت بعد إضافة ملف؟

قد تتغير الأرقام إذا أضفت ملفًا يسبق الملفات الحالية في ترتيب الأسماء ثم أعدت الترقيم. إذا كانت الأسماء مستخدمة في روابط منشورة أو قاعدة بيانات، فلا تعِد بناء التسلسل كله كل مرة. احتفظ بمعرف مستقل عن اسم العرض، أو رقّم الملفات الجديدة فقط بسياسة واضحة. وقبل أي تعديل راجع الخطة الجديدة مقارنة بالسجل السابق حتى لا تتحول مهمة تنظيم بسيطة إلى تغيير مراجع يعتمد عليها التطبيق.

يعتمد المثال على safe_rename.py من درس توحيد أسماء الملفات؛ احفظ الملفين معًا خارج مجلد البيانات.

المراجع الرسمية

شاهد أيضًا
مقالات ذات صلة
🚫 مانع الإعلانات مفعل

يجب إيقاف مانع الإعلانات لاستكمال تصفح الموقع