الحالة الصحيحة وتنسيق المتغير والأساليب والبيثون

StackOverflow https://stackoverflow.com/questions/1732234

سؤال

لذلك أعرف أن بعض اللغات توقع اتفاقيات.

بي أتش بي - underscore_case() بالنسبة للجزء الأكبر، Lolo

جافا - camelCase()

ج # - PascalCase()

إلخ.

ما هي اتفاقية تسمية "بيثوني"؟ أعلم أنه لا يهم في النهاية ولكن فقط أتساءل عما إذا كانت هناك طريقة "أفضل الممارسات" التي تتم فيها معظم الوحدات النمطية.

هل كانت مفيدة؟

المحلول

كلمتان: بيب 8..

PEP 8 هي دليل أسلوب بيثون (De Facto). بعض النقاط البارزة من هذه الوثيقة (تركت بعض الاشياء عن قصد؛ اذهب قراءة المستند الأصلي للأصوات والخارج):

  • أسماء الحزمة والوحدة: جميع الأسماء الصغيرة. يمكن استخدام السفلات السفلية في اسم الوحدة النمطية إذا كان تحسين قابلية القراءة.

  • أسماء الفئة: تقريبا دون استثناء، تستخدم أسماء الفئات اتفاقية Capwords. *

  • الأسماء العالمية المتغيرة: الاتفاقيات هي نفسها مثل تلك الخاصة بالوظائف.

  • أسماء الوظائف: يجب أن تكون أسماء الوظائف صغيرة، مع فصل الكلمات عن طريق السفلية حسب الضرورة لتحسين قابلية القراءة. يسمح mixedcase فقط في السياقات حيث هذا هو النمط السائد بالفعل (على سبيل المثال threading.py)، للاحتفاظ بالتوافق مع الوراء.

  • أسماء الأسلوب ومتغيرات المثيل: صغيرة بالكلمات مفصولة عن طريق السفلات اللازمة لتحسين قابلية القراءة. استخدم إحدى السفلات السفلية الرائدة فقط لأسلوب غير عامة ومتغيرات المثيل.

  • الثوابت: مكتوب بكل الحروف الكبيرة مع الشرطة السفلية فصل الكلمات. الامثله تشمل.

نصائح أخرى

اقرأ بيب 8..

إنه دليل أسلوب لرمز بيثون، الذي كتبه خالق بايثون، Guido Van Rossum.

بالمناسبة، الجواب على سؤالك هو استخدام underscore_case للمتغيرات وأسماء الوظائف، و PascalCase للفصول الدراسية.

كلمات سبعة: جوجل الصيف من كود دليل نمط بيثون

لاحظ أن بعض اتفاقيات التسمية تختلف عن PEP8 وبدلا من ذلك اتبع دليل أسلوب Google Python الأصلي الذي نشأ منه الدليل النمط.

  • يعني "الداخلية" الداخلية إلى وحدة نمطية أو محمية أو خاصة داخل الفصل. بإعداد تسطير الأسفل الواحد (_) لديه بعض الدعم لحماية متغيرات الوحدة النمطية والوظائف (غير المدرجة في الاستيراد * من).
  • تقوم بإعداد تدوية مزدوجة (__) بمتغير مثيل أو طريقة تعمل بفعالية لجعل المتغير أو الطريقة الخاصة من القطاع الخاص إلى فئةها (باستخدام اسم Mangling).
  • وضع الفصول ذات الصلة وظائف المستوى الأعلى معا في وحدة نمطية. على عكس جافا، ليست هناك حاجة للحد من نفسك إلى فئة واحدة لكل وحدة. ومع ذلك، تأكد من أن الفصول الدراسية ووظائف المستوى الأعلى في نفس الوحدة لها تماسك مرتفع.
  • استخدم الكلمات Capwords لأسماء الفصل، ولكن Lower_with_under.py لأسماء الوحدة النمطية.

أمثلة تسمية

  • حزم: lower_with_under
  • الوحدات: lower_with_under, _lower_with_under
  • الطبقات: CapWords, _CapWords
  • استثناءات: CapWords
  • المهام: firstLowerCapWords(), _firstLowerCapWords()
  • الثوابت العالمية / الصف: CAPS_WITH_UNDER, _CAPS_WITH_UNDER
  • المتغيرات العالمية / الطبقة: lower_with_under, _lower_with_under
  • متغيرات سريعة: lower_with_under, _lower_with_under (محمي) أو __lower_with_under (نشر)
  • أسماء الأساليب: firstLowerCapWords(), _firstLowerCapWords() (محمي) أو __firstLowerCapWords() (نشر)
  • المعلمات الوظيفية / الطريقة: lower_with_under
  • المتغيرات المحلية: lower_with_under
مرخصة بموجب: CC-BY-SA مع الإسناد
لا تنتمي إلى StackOverflow
scroll top