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

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

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

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

• اصول کلی General Principles

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

• انسجام (Cohesion) Cohesion

• اتصال (Coupling) Coupling

• جداسازی دغدغه‌ها 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

• دمو: شناسایی بوی بد کد با 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 Review) Code Reviews

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

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