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

PEP 8: Style Guide for Python

PEP 8 is the official fashion guide for Python code. It provides conventions for indentation, line length, naming, and more. Following PEP 8 helps keep code uniform across projects and teams.

اتفاقيات تسمية

استخدام الأسماء الوصفية للمتغيرات والوظائف والصفوف اتبع أساليب التسمية الموحدة:

  • snake case] for functions andتغييرات
  • CapWords
  • Constants in UPPER CASE]

الهيكل والتعليقات

(ج) تنظيم الشفرة في الوظائف والنماذج لتحسين إمكانية القراءة، واستخدام التعليقات لشرح المنطق المعقّد، ولكن تجنب التعليقات الزائدة عن الحاجة، وكتابة نقاط واضحة للمهام والصفوف.

أفضل الممارسات للاستمرارية

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