Faragiri
العربية

كل اللغات

تعلم السكربتات والأتمتة بايثون

سكربت يرتب مجلد إيصالات في الشارقة، الفخ في نمط البحث الذي يفوت نصف الملفات، والوسيطة التي تحول فشلا صامتا إلى خطأ يُرى.

4الأقسام
3دقائق القراءة
4العمق

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

سيُعاد تسمية 'SCN_014 نسخة.JPG' إلى 'scn_014.jpg'، وسيُعاد تسمية 'SCN_015.jpeg' إلى 'scn_015.jpeg'، وسيُعاد تسمية 'SCN_016.JPG' إلى 'scn_016.jpg'.

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

العثور على الملفات، والفخ في النمط

Path("إيصالات").rglob("*.JPG") تُجيب اثنين من الملفات الثلاثة فقط، لأن أنماط glob حساسة لحالة الأحرف وأحد الملفات لاحقته jpeg بأحرف صغيرة. هذا أشيع خطأ في سكربت الترتيب، وهو صامت: التشغيل يُبلغ نجاحا ونصف المجلد لم يُمس.

قبل أول إعادة تسمية

ما يتحقق منه الفحص الصريح للواحق

فحص اللواحق بمقارنة صريحة يحمي من أخطاء الأنماط الصامتة التي تترك نصف المجلد دون معالجة.

  1. نعممطابقة أسماء JPG الكبيرةأسلوب rglob يلتقط الأحرف الكبيرة فقط ولا يمس غيرهانعم
  2. لاالتقاط لاحقة jpeg الصغيرةفخ نمط glob الحساس لحالة الأحرف يتجاهلها بصمتلا
  3. نعمتوحيد فحص اللواحق بأحرف صغيرةاختبار p.suffix.lower يمسك جميع الامتدادات المستهدفةنعم
  4. نعمالمسح المباشر عبر iterdirمقارنة صريحة تتفادى أخطاء أنماط البحث الصامتةنعم

مطابقة النمط وحدها تفوت الامتدادات الصغيرة، واستخدام دالة iterdir مع مقارنة صريحة للواحق هو الضمان لاكتمال الملفات.

النسخة الموثوقة تختبر اللاحقة لا النمط: if p.suffix.lower() in {".jpg", ".jpeg"}، وهذا التعبير أمسك الملفات الثلاثة. استعيني بدالة iterdir ومقارنة صريحة حين تهم الدقة، واحتفظي بأسلوب rglob للحالات التي تتحكمين فيها بالأسماء نفسها.

الاتصال بأداة خارجية، والوسيطة التي يُغفل عنها

حين يحتاج العمل أداة حقيقية، فإن subprocess.run هي الطريق، وهي تأخذ قائمة لا نصا واحدا، وهذا ما يمنع اسم ملف فيه مسافة من أن يتحول إلى وسيطتين منفصلتين.

تسلسل استدعاء الأدوات

حلقات تشغيل الأوامر الخارجية

تمرير الوسائط في قائمة وفحص رمز الخروج هما ضامنا عدم انقطاع المعالجة أو إتلاف الملفات.

الحلقة الضعيفة هي تشغيل الأمر بلا check=True، حيث يتجاهل السكربت رمز الخروج غير الصفري ويواصل العمل كأن التحويل نجح.

subprocess.run([...], capture_output=True, text=True) تعيد كائنا فيه returncode وstdout كنص، وتشغيل ناجح على إيصال هاني أجاب بالسطر الأخير 1240x1754، وهو مقاس الصورة بالبكسل الذي أعادته أداة فحص الصور.

الوسيطة التي تُضاف هي check=True. من دونها، أمر فاشل يجيب رمزا غير صفري ويتابع السكربت عمله كأن شيئا لم يكن؛ subprocess.run(["false"], check=True) يرفع CalledProcessError بدلا من ذلك، وهذا ما تحتاجينه حين تفترض الخطوة التالية أن السابقة نجحت. سكربت ترتيب يتجاهل رموز الخروج سيحذف الأصول بسعادة بعد تحويل فشل.

pathlib وlaunchd، هذا العام

pathlib هي إجابة المكتبة القياسية لأي شيء يمس نظام الملفات، مجانية، وهي الموصى بها منذ سنوات. p.suffix وp.stem وp.with_name وp.rename حلت محل جراحة النصوص على المسارات بواسطة os.path.splitext والدمج اليدوي، وهناك كانت تعيش علة المسافة في اسم الملف.

أدوات النظام المدمجة

ترسانة العمل المستقر على ماك

إدارة مسارات الملفات دون جراحة نصوص بالتكامل مع جدولة مهام تضمن استئناف العمل بعد الإقلاع.

  • مكتبة pathlib
  • خدمة launchd
  • مكتبة pathlibمعالجة اللواحق وتعديل الأسماء عبر p.suffix وp.with_name دون مخاطر المسافات
  • خدمة launchdجدولة التشغيل عبر ملفات plist في مجلد LaunchAgents مع إعادة التشغيل التلقائي

ترابط المسارات الصريحة مع الجدولة النظامية يمنع تعطل الأتمتة عند تغير بيئة العمل أو إعادة تشغيل الجهاز.

launchd هي ما يضع السكربت على جدول على جهاز ماك، مجانية مع النظام، وهي حلت محل cron هناك: ملف plist في مجلد LaunchAgents يعمل على فترة أو عند الدخول، وخلافا لأداة cron يعيد تشغيل المهمة بعد إعادة الإقلاع. أيا كان ما يجدولها، تذكري ما يتغير: التشغيل المجدول له مجلد عمل مختلف ومسار PATH أضيق بكثير من الطرفية، فاستخدمي مسارات مطلقة لكل شيء، بما فيها المفسر نفسه.

أين يتعثر جدولة السكربت

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

أسباب التعثر الصامت

ركائز التشغيل الآمن في الجدولة

الاعتماد على بيئة الطرفية التفاعلية هو فخ الجدولة؛ مسارات ثلاثة مطلقة تضمن نجاح العمل عند الثالثة فجرا.

  • مسار مطلق لمجلد العمليمنع فشل المسارات النسبية التي تبحث في موضع غير متوقع
  • مسار مطلق لمفسر بايثونيضمن استدعاء البيئة التي تحوي حزم العمل المحددة
  • مسار مطلق لملف السجليجعل مخرجات الفشل مرئية للتشخيص بدلا من ضياعها

بيئة تشغيل نظيفة ومستقلة

غياب أي ركيزة من هذه الثلاث يترك السكربت يعمل في بيئة افتراضية عمياء تفشل دون إظهار أخطاء واضحة.

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

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

بجانب هذه العقدة

فوق هذه العقدة