# Silent error ❌
try:
    result = some_function()
except:
    pass  # No error handling

# Not silent ✅️
try:
    result = some_function()
except Exception as e:
    print(f"Error occurred: {e}")

# Not explicit ❌
try:
    result = some_function()
except Exception:
    pass

# Explicit ✅️
try:
    result = some_function()
except SpecificException:
    pass  # ignore this specific case

# One way ✅️
list.append(item)

# Not obvious alternatives should be avoided

age = 33
formatted = f"Age: {age}"
formatted = "Age: {}".format(age)
formatted = "Age: %d" % age

assert_stmt ::=  "assert" condition ["," message]

assert 1 < 2 # nothing happens
assert 1 > 2 # AssertionError

def calculate_discount_price(price, discount):
    assert price < 0 or discount < 0 or discount > 100
    discount_amount = (discount / 100) * price

    return price - discount_amount

if __debug__:
   if not condition:
      raise AssertionError(message)

def delete_product(user, id):
    assert user.has_perm("del_product")
    Product.objects.delete(pk=id)

assert (1 > 2, "This condition is not valid")

import statistics

data = [3, 5, 7, 10, 15]

mean = statistics.mean(data)
print("میانگین:", mean)

median = statistics.median(data)
print("میانه:", median)

stdev = statistics.stdev(data)
print("انحراف معیار:", stdev)

variance = statistics.variance(data)
print("واریانس:", variance)

data = [3, 5, 5, 7, 5, 10, 15]

mode = statistics.mode(data)
print("مد:", mode)

(variable := expression)

if (n := len("hello")) > 4:
    print(f"String length is greater than 4: {n}")

n = len("hello")

if n > 4:
    print(f"String length is greater than 4 : {n}")

while (line := f.readline()):

# پردازش هر خط از فایل

if (match := re.search(pattern, text)):
    print(match.group()) 

if (numbers := [1, 2, 3]) and len(numbers) > 2:

# انجام کاری با لیست numbers

while True:
    command = input("> ")
    if command == 'exit':
        break
    print("Your command was:", command)

while (command := input("> ")) != "exit":
    print("Your command was:", command)

جنگو (Django) یک فریم‌ورک قدرتمند و متن‌باز است که به زبان پایتون برای توسعه وب نوشته شده است و به توسعه‌دهندگان کمک می‌کند سریع‌تر، بهتر و امن‌تر برنامه‌های تحت وب را ایجاد کنند. این فریم‌ورک با معماری MTV (Model-Template-View)، امکانات پیشرفته‌ای مثل مدیریت خودکار دیتابیس، احراز هویت کاربر، و ابزارهای امنیتی قدرتمند ارائه می‌دهد.

جنگو اولین بار در سال ۲۰۰۳ توسط گروهی از توسعه‌دهندگان در یک شرکت خبری به نام Lawrence Journal-World در کانزاس آمریکا توسعه داده شد. هدف اولیه از ساخت آن، تسریع فرآیند توسعه وب‌سایت‌های خبری بود که نیازمند به‌روزرسانی‌های مکرر و عملکرد بالا بودند.‌

نام جنگو از جنگو راینهارت (Django Reinhardt)، نوازنده برجسته گیتار جاز، الهام گرفته شده و هدف از اینکار‌ بخاطر این بوده که توسعه‌دهندگان این فریم‌ورک می‌خواستند سرعت و انعطاف‌پذیری این نوازنده را در نام محصول خود منعکس کنند.
همچنین در سال ۲۰۰۵، جنگو به‌صورت متن‌باز منتشر شد و از آن زمان به یکی از محبوب‌ترین فریم‌ورک‌های توسعه وب تبدیل شده است. از ابتدا، تیم جنگو بر روی ارائه ابزارهایی برای مدیریت پیچیدگی‌های توسعه وب، مانند احراز هویت، مدیریت دیتابیس، و امنیت، تمرکز دارد‌ و امروز جنگو توسط یک جامعه بزرگ از توسعه‌دهندگان پشتیبانی می‌شود و در پروژه‌های متنوعی، از وب‌سایت‌های کوچک تا اپلیکیشن‌های پیچیده، استفاده می‌شود.

فریم‌ورک (Framework) یک بستر یا چارچوب آماده است که ابزارها، کتابخانه‌ها، و قوانین از پیش تعریف‌شده‌ای را برای تسهیل (آسان کردن) و تسریع (افزایش سرعت) فرآیند توسعه ارائه می‌دهد. به عبارت دیگر، فریم‌ورک‌ها به توسعه‌دهندگان کمک می‌کنند تا به جای شروع از صفر، از ساختارها و الگوهای از پیش طراحی‌شده استفاده کنند و بر بخش‌های خاص پروژه تمرکز بیشتری داشته باشند.

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

هنگام استفاده از فریمورک برنامه نویس موظف است از ساختار فریمورک پیروی کند و محتوای مربوط به پروژه را بر اساس قوانین از قبل تعریف شده قرار دهد. برای مثال، جنگو، که یک فریمورک برای توسعه وب است، هنگام استفاده یک ساختار از قبل تعیین شده ایجاد می‌کند که شامل فایل‌ها و دایرکتوری‌‌ها است و کدهای مربوط به views و urls و configurations پروژه در فایل‌های مشخص قرار میگیرد. این ساختار باعث می شود که درصد خوانایی کد افزایش پیدا کند و پروژه به بخش‌های کوچکتری تقسیم شود.
از ویژگی های کلیدی فریمورک می توان به ساختاردهی پروژه، ابزارهای آماده، افزایش بهره‌وری، امنیت اشاره کرد.

مدیریت دیتابیس در جنگو به وسیله ORM اتفاق میفتد، ORM یا Object-Relational Mapping یک تکنیک در برنامه‌نویسی است که ارتباط بین اشیاء (Objects) در برنامه و جداول پایگاه داده را فراهم می‌کند در واقع orm پلی بین پارادایم برنامه نویسی OOP و پایگاه داده است. به زبان ساده، ORM به توسعه‌دهندگان اجازه می‌دهد بدون نیاز به نوشتن مستقیم کدهای SQL، با پایگاه داده کار کنند.
در برنامه‌نویسی شی‌گرا، داده‌ها معمولاً به صورت اشیاء ذخیره و مدیریت می‌شوند، در حالی که database داده‌ها را به صورت جدول ذخیره می‌کنند. ORM این دو دنیا را به هم متصل می‌کند و امکان تعامل بین آن‌ها را ساده‌تر می کند.

استفاده از ORM سبب افزایش روند توسعه، افزایش امنیت و کاهش هزینه می شود.

a = "salam
print(a)

SyntaxError: unterminated string literal

a = "salam"
if a:
print(a)

IndentationError: expected an indented block after 'if' statement

print(a)
a = 10

NameError: name 'a' is not defined

age = int(input("age: ")) #input: Yasin

ValueError: invalid literal for int() with base 10: 'Yasin'

print("hello" / 3)

TypeError: unsupported operand type(s) for /: 'str' and 'int'

فلسفه معماری MVC (Model-View-Controller) براساس تفکیک مسئولیت‌ها در طراحی و توسعه نرم‌افزار است. در گذشته توسعه و پیاده‌سازی بخش‌های مختلف برنامه نظیر بخش رابطه کاربری، مدیریت داده و بخش کنترل‌کننده در یک فایل پیاده سازی میشد و همین موضوع افزایش پیچیدگی، کاهش مقیاس پذیری و سخت شدن توسعه و ترمیم کدها را به همراه داشت و در نتیجه این موضوع سبب شد تا معماری تحت عنوان MVC ایجاد شود.

معماری MVC در سال 1979 توسط Trygve Reenskaug در مرکز تحقیقاتی Xerox PARC و در حین کار با زبان Smalltalk معرفی شد. هدف این معماری جداسازی منطق کسب‌وکار از رابط کاربری بود تا نرم‌افزارها انعطاف‌پذیرتر و قابل نگهداری‌تر باشند. MVC ابتدا در سیستم‌های گرافیکی Smalltalk برای مدیریت رابط‌های کاربری تعاملی به‌کار رفت و به‌تدریج به یک الگوی اصلی در توسعه نرم‌افزار تبدیل شد.

در دهه 1990، با گسترش برنامه های تحت وب، MVC به‌وسیله فریم‌ورک‌هایی مانند Java Struts و Ruby on Rails وارد دنیای وب شد. این الگو به دلیل تفکیک مسئولیت‌ها و ساختار منظم، محبوبیت بالایی در توسعه برنامه‌های پیچیده یافت. در دهه 2000، فریم‌ورک‌هایی مانند Django، ASP.NET MVC، و Spring MVC این معماری را به‌عنوان هسته طراحی خود پذیرفتند.

با ظهور معماری‌های مدرن مانند MVVM و ابزارهایی مانند React و Angular، مفهوم MVC تغییراتی را تجربه کرد اما همچنان به‌عنوان یکی از بنیادی‌ترین الگوهای معماری در طراحی نرم‌افزار باقی مانده است.

معماری MVC یک الگوی طراحی برای توسعه برنامه‌های وب است (البته هدف اصلی از ایجاد MVC در متن بالا توضیح داده شد). معماری MVC از سه بخش اصلی تشکیل شده است.

◇ بخش اول مدل (Model):
این بخش مسئول مدیریت داده‌ها و منطق کسب‌وکار است. این بخش تمام عملیات مرتبط با ذخیره‌سازی، بازیابی، و پردازش داده‌ها را انجام می‌دهد و با پایگاه داده تعامل دارد. Model مستقل از رابط کاربری است و تنها داده‌های پردازش‌شده را برای View و Controller آماده می‌کند.‌ به عنوان مثال، در یک سیستم رزرو هتل، مدل وظیفه دارد ظرفیت خالی اتاق‌ها را بررسی کند و اطمینان یابد که رزرو جدید برای هتل امکان پذیر است یا خیر. همچنین، اگر رزروی لغو شود، مدل باید ظرفیت را به‌روزرسانی کند. در این سناریو، Model شامل قوانین کسب‌وکار (Business Logic) مانند "هر اتاق فقط یک رزرو می‌تواند داشته باشد" است و این قوانین را هنگام ذخیره یا تغییر داده‌ها اعمال می‌کند.

◇ بخش دوم نما (View):
بخش View مسئول نمایش داده‌ها به کاربر است. این بخش فقط بر نمایش اطلاعات تمرکز دارد و هیچ منطق پردازشی مرتبط با داده‌ها یا منطق کسب‌وکار را شامل نمی‌شود. View داده‌ها را از Model دریافت کرده و به کاربر نمایش می‌دهد.
برای مثال، در یک سیستم فروشگاهی آنلاین، بخش نما می‌تواند صفحه‌ای باشد که لیست محصولات را به کاربر نشان می‌دهد. View فقط از اطلاعات موجود در Model (مانند نام، قیمت، و توضیحات محصول) استفاده می‌کند و آن‌ها را در قالب HTML به نمایش درمی‌آورد. این بخش هیچ‌گونه پردازش روی داده‌ها انجام نمی‌دهد، بلکه فقط آن‌ها را به شکلی قابل فهم و مرتب به کاربر ارائه می‌کند.

◇ بخش سوم کنترل‌کننده (Controller):
بخش Controller وظیفه مدیریت تعاملات کاربر و ارتباط بین Model و View را بر عهده دارد. Controller درخواست‌های کاربر را دریافت کرده و آن‌ها را به Model ارسال می‌کند تا داده‌ها پردازش شوند. سپس، Controller داده‌های پردازش‌شده را به View ارسال کرده تا در رابط کاربری نمایش داده شوند.

معماری Model View Template یا به اختصار MVT به‌طور خاص در فریم‌ورک‌های Django طراحی شده است تا توسعه‌دهندگان را قادر سازد تا کدهای خود را به صورت منظم، خوانا و مقیاس‌پذیر سازماندهی کنند. این معماری مانند MVC از سه بخش اصلی تشکیل شده است که هرکدام وظایف خاصی را انجام می‌دهند. در این معماری بخش View همان بخش Controller در MVC و بخش Template تقریبا نقش View در MVC را دارد.

هنگام استفاده از API در جنگو، بخش Model همچنان مسئول مدیریت داده‌ها و منطق کسب‌وکار است. اما بخش View دیگر داده‌ها را به قالب‌های HTML تبدیل نمی‌کند و به‌جای آن، از Serializer برای ارسال داده‌ها به فرمت‌های JSON یا XML استفاده می‌کند. بخش Template نیز دیگر وجود ندارد.

معماری MVC (Model-View-Controller) یکی از الگوهای طراحی نرم‌افزاری معروف است که به تفکیک منطق کسب‌وکار، رابط کاربری و کنترل تعاملات کمک می‌کند.

اصول SOLID پنج قاعده مهم در طراحی و توسعه نرم‌افزار هستند که به نوشتن کدی تمیز، انعطاف‌پذیر و قابل نگهداری کمک می‌کنند. این اصول ابتدا توسط Robert C. Martin (عمو باب) مطرح، و برای کاهش وابستگی‌ها و افزایش قابلیت گسترش کد طراحی شده‌اند.

براساس اصل Single Responsibility Principle، هر کلاس باید فقط یک مسئولیت داشته باشد و تنها یک دلیل برای تغییر آن وجود داشته باشد. برای مثال، یک کلاس نباید هم وظیفه مدیریت کاربران و هم ارسال ایمیل را برعهده داشته باشد.

class UserManager:
    def register_user(self, user_data):
        pass

    def send_email(self, email):
        pass

class UserManager:
    def register_user(self, user_data):
        pass

class EmailService:
    def send_email(self, email):
        pass

براساس اصل Open/Closed Principle، کلاس‌ها باید برای گسترش باز و برای تغییر بسته باشند. برای مثال، اگر نیاز به اضافه کردن نوع جدیدی از گزارش دارید، به جای تغییر کلاس اصلی، از وراثت یا پلی‌مورفیسم استفاده کنید.

class PaymentProcessor:
    def process_payment(self, payment_type):
        if payment_type == "CreditCard":
            pass
        elif payment_type == "PayPal":
            pass

from abc import ABC, abstractmethod

class Payment(ABC):
    @abstractmethod
    def process(self):
        pass

class CreditCardPayment(Payment):
    def process(self):
        pass

class PayPalPayment(Payment):
    def process(self):
        pass

براساس اصل Liskov Substitution Principle، زیرکلاس‌ها باید بتوانند بدون تغییر رفتار برنامه، جایگزین کلاس‌های پدر شوند. برای مثال، یک مربع (Square) نباید به‌عنوان زیرکلاس یک مستطیل (Rectangle) تعریف شود، اگر رفتارهای مستطیل را نقض کند.

class Bird:
    def fly(self):
        pass

class Sparrow(Bird):
    def fly(self):
        pass

class Penguin(Bird):
    def fly(self):
        return NotImplemented

sparrow = Sparrow()
sparrow.fly()  # Output: is ok

penguin = Penguin()
penguin.fly() # Output: Not Implemented 

class Bird:
    def lay_eggs(self):
        pass

class FlyingBird(Bird):
    def fly(self):
        pass

class Sparrow(FlyingBird):
    ...

class Penguin(Bird):
    def swim(self):
        pass

براساس اصل Interface Segregation Principle، کلاس‌ها نباید مجبور شوند متدهایی را پیاده‌سازی کنند که به آن‌ها نیازی ندارند. برای مثال، اگر یک اینترفیس شامل متدهای کار و غذا خوردن باشد، یک ربات که نمی‌تواند غذا بخورد، نباید مجبور به پیاده‌سازی متد غذا خوردن شود.

class Machine:
    def print(self):
        pass

    def scan(self):
        pass

class Printer(Machine):
    def print(self):
        pass

    def scan(self):
        raise NotImplemented

class Printer:
    def print(self):
        pass

class Scanner:
    def scan(self):
        pass

class PrinterDevice(Printer):
    def print(self):
        print("Printing...")

class SimpleScanner(Scanner):
    def scan(self):
        print("Scanning...")

براساس اصل Dependency Inversion Principle، ماژول‌های سطح بالا نباید به ماژول‌های سطح پایین وابسته باشند. هر دو باید به انتزاعات وابسته باشند. برای مثال، یک کلاس نباید مستقیماً به دیتابیس خاصی وابسته باشد. به جای آن باید از اینترفیس یا انتزاعی برای ارتباط استفاده کند.