وب‌سرویس مجید

پروژه elements-of-python-style

amontalenti/elements-of-python-style

این پروژه دربارهٔ نوشتن کد پایتونی صحبت می‌کند که نه فقط از نظر فنی درست باشه، بلکه از نظر سبک و خوانایی هم عالی باشه.

کاربرد:

این راهنما به تو کمک می‌کنه کدی بنویسی که برای دیگران راحت‌تر قابل فهم باشه و حس "خوب نوشته‌شده‌بودن" داشته باشه — مثل کتاب معروف Strunk & White برای زبان انگلیسی، اما برای پایتون.

در چه شرایطی بهتره استفاده شود؟

وقتی می‌خوای به عنوان یک توسعه‌دهنده پایتون، فراتر از قوانین پایه‌ای مثل PEP8 حرکت کنی و کد حرفه‌ای‌تر و تمیزتری بنویسی. مناسب تیم‌های توسعه، پروژه‌های اوپن‌سورس و کسایی که می‌خوان کدشون مثل یک متخصص به نظر برسه. ‍‍

چند مثال از موارد استفاده:

- نوشتن توابع کوتاه و متمرکز با مسئولیت واحد

- انتخاب نام‌های معنادار برای متغیرها و توابع

- ساختاردهی به کد برای خوانایی بهتر (حتی اگر کار فنی همون باشه)

- استفاده هوشمندانه از کامنت‌ها و مستندات

- پرهیز از پیچیدگی‌های غیرضروری

  • ##Python
  • ##CodeStyle
  • ##CleanCode
  • ##BestPractices
  • ##Readability
  • ##ProgrammingTips
  • ##SoftwareEngineering
  • ##DeveloperExperience
  • ##OpenSource
  • ##CodingGuidelines