آموزش پایتون: اصول کدنویسی تمیز (Clean Code) - آخرین آپدیت

سرفصل ها و درس ها

بهترین روش‌ها برای کدنویسی قابل نگهداری Best Practices for Maintainable Code

• کد خوب چیست؟ What Is Good Code?

• اصول کلی General Principles

• ساختار کد و اصل تک مسئولیتی (SRP) Code Structure and the Single Responsibility Principle

• انسجام (Cohesion) Cohesion

• اتصال (Coupling) Coupling

• تفکیک دغدغه‌ها (Separation of Concerns) Separation of Concerns

• اصل تکرار نکن (DRY) Don't Repeat Yourself

• نام‌گذاری Naming

• توابع Functions

• آرگومان‌های توابع Function Arguments

• کلاس‌ها Classes

پیروی از استانداردهای استایل پایتون: Pep8 Following Python Style Guidelines: Pep8

• PEP چیست؟ What Is a Pep?

• مروری بر Pep8 Pep8 Overview

• دمو: پیاده‌سازی Pep8 در عمل Demo: Pep8 in Practice

• قوانین تکمیلی Pep8 More Pep8 Rules

• مرور کلی: Pep8 Review: Pep8

• دمو: شناسایی بوی بد کد (Code Smells) با Pylint Demo: Detect Code Smells with Pylint

• دمو: شناسایی بوی بد کد با Ruff Demo: Code Smells with Ruff

• دمو: فرمت‌بندی کد با Ruff و Black Demo: Formatting with Ruff and Black

• دمو: استفاده از Linters در VS Code Demo: Linters with VS Code

مستندسازی پروژه Documenting Your Project

• مقدمه: Docstrings و Pep257 Intro: Docstrings and Pep257

• دمو: تولید مستندات HTML با Sphinx Demo: Generating HTML Documentation with Sphinx

• دمو: متن‌های ساختاریافته (Restructured Text) Demo: Restructured Text

• دمو: Docstrings و Sphinx Demo: Docstrings and Sphinx

• دمو: تولید مستندات از DocStrings با Apidoc Demo: Generating Documentation from DocStrings with Apidoc

مدیریت خطاها Error Handling

• استثناها در کجا رخ می‌دهند؟ Where Do Exceptions Occur?

• کدام استثناها را باید مدیریت کرد؟ Which Exceptions to Catch

• مسئولیت‌ها و لایه‌ها Responsibilities and Layers

• الگوهای استثنا (Exception Patterns) Exception Patterns

• ایجاد استثناها (Raising Exceptions) Raising Exceptions

بازبینی کد Code Reviews

• مقدمه: هرم بازبینی کد Intro: The Code Review Pyramid

• نکاتی برای بازبینی عالی کد Tips for Great Code Reviews