الإعلان بشكل صحيح عن تشفير كود مصدر بايثون

يوضح PEP 263 الممارسة القياسية للإعلان عن تشفير كود مصدر بايثون. في حين أن الاصطلاح النموذجي يتضمن استخدام "# -- coding: --"، فإنه ليس من غير المألوف مواجهة الاختلافات التي تستخدم "# -- encoding: --".

إذن، ما هو الشكل الصحيح لإعلان التشفير؟

وفقًا لوثائق بايثون، أ تتم معالجة التعليق الذي يطابق التعبير العادي التالي في السطر الأول أو الثاني من برنامج Python النصي كإعلان ترميز:

coding[=:]\s*([-\w.] )

النماذج الموصى بها:

يتم توفير نموذجين موصى بهما:

• # -*- الترميز: -*-
• # vim:fileencoding=

تم التعرف على الأول بواسطة GNU Emacs، بينما الأخير خاص بـ Vim.

اعتبارات التوافق:

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

على سبيل المثال، يتعرف GNU Emacs على نموذج الترميز الجاهز، لكن Vim لا يتعرف عليه. لذلك، من الضروري استخدام نموذج متوافق مع كل من Python وبيئة التحرير التي اخترتها.