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، ماژول‌های سطح بالا نباید به ماژول‌های سطح پایین وابسته باشند. هر دو باید به انتزاعات وابسته باشند. برای مثال، یک کلاس نباید مستقیماً به دیتابیس خاصی وابسته باشد. به جای آن باید از اینترفیس یا انتزاعی برای ارتباط استفاده کند.

with open("test.txt", "r") as t:
    t.read()

FileNotFoundError: [Errno 2] No such file or directory: 'test.txt'

import requests

ModuleNotFoundError: No module named 'requests'

names = ["Yasin", "Reza", "Navid"]
print(names[5])

IndexError: list index out of range

names = {'Yasin': '1', 'Reza': '2'}
print(names['3'])

KeyError: '3'

numbers = [1, 2, 3]
print(numbers.sum())

AttributeError: 'list' object has no attribute 'sum'

name = "Yasin"
def get_name():
    print(name)
    name = "ali"

    print(name)

get_name()

UnboundLocalError: cannot access local variable 'name' where it is not associated with a value

unicode_str = b"\u1234\u5678\u90AB"
print(decoded_str.decode("ascii"))

UnicodeDecodeError: 'ascii' codec can't decode byte 0xe1 in position 0: ordinal not in range(128)

result = 5 / 0

ZeroDivisionError: division by zero

large_list = [0] * 1_000_000_000

import os

os.mkdir(r"C:\Windows\System32\new_directory")

احتمالا با محیط‌ مجازی در پایتون آشنا هستید و ازش استفاده کردید. محیط مجازی یک ابزاری است که به شما این امکان را می‌دهد تا یک محیط ایزوله برای پروژه‌های خود ایجاد کنید. این ایزوله‌سازی به شما کمک می‌کند تا کتابخانه‌ها و وابستگی‌های هر پروژه را جداگانه مدیریت کنید، بدون اینکه با سایر پروژه‌ها یا سیستم اصلی تداخل داشته باشند. هر پروژه می‌تواند نسخه‌های متفاوتی از یک کتابخانه را داشته باشد. وابستگی‌ها و تغییرات یک پروژه بر پروژه‌های دیگر تأثیری ندارند. محیط مجازی به شما کمک می‌کند تا وابستگی‌ها را به راحتی مدیریت کنید و آن‌ها را در فایل requirements.txt ذخیره کنید. روش‌های متفاوتی برای ایجاد یک محیط ایزوله وجود دارد که در ادامه با دو روش متفاوت محیط مجازی پروژه را ایجاد می‌کنیم و سپس به نصب جنگو و ایجاد اولین پروژه جنگو می‌پردازیم.

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

# Linux
python3 -m venv env

# Windows
python -m venv env

بعد از ایجاد محیط مجازی باید آن را فعال کنید.

# Windows
venv\Scripts\activate

# Linx
source venv/bin/activate

ابزار uv یک ابزار بسیار سریع برای مدیریت بسته‌ها و پروژه‌های پایتون است که با زبان Rust توسعه یافته است. این ابزار به عنوان جایگزینی برای ابزارهایی مانند pip، pip-tools، pipx، poetry، pyenv، twine و virtualenv طراحی شده و امکانات گسترده‌ای را برای مدیریت وابستگی‌ها، محیط‌های مجازی، نسخه‌های پایتون و اجرای اسکریپت‌ها فراهم می‌کند. برای استفاده ابتدا باید uv را نصب کنید.

# Windows 
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

# Linux 
curl -LsSf https://astral.sh/uv/install.sh | sh

در ادامه برای ایجاد محیط مجازی تنها با وارد کردن uv و در ادامه venv محیط مجازی ایجاد می شود.

uv venv

مراحل نصب جنگو نسبتا پروسه راحتی است و صرفا باید فریمورک جنگو را با استفادهِ یکی از روش زیر با توجه به مراحل قبل نصب کنید.

# venv
pip install django

# uv
uv add django

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

# Venv
django-admin startproject project_name

# UV
uv run django-admin startproject project_name

#‌ Change Directly (both Windows & Linux)
cd project_name

در نهایت برای اجرا پروژه با استفاده از دستور زیر می‌توانید پروژه جنگو را روی آدرس لوکال اجرا کنید.

# Venv
python manage.py runserver

# UV
uv run manage.py runserver

number = int(input("enter a number: ")
print(number - 1)
print("bye")

ValueError: invalid literal for int() with base 10

try:
    number = int(input("enter a number: "))

except:
    print("the entry isn't an integer")

print("bye")

try:
    number = int(input("enter a number: "))
    print(1e3 / number)

except ValueError:
    print("the entry isn't an integer")

try:
    number = int(input("enter a number: "))
    print(1e3 / number)

except ValueError:
    print("the entry isn't an integer")

except ZeroDivisionError:
    print("entry cannot be zero")

def divide(x, y):
    try:
        result = x // y
        print("Yeah! Your answer is :", result)

    except Exception as e:
        print("The error is: ", e)

divide(3,0)

def get_number():
    try:
        number = int(input("number: "))

    except:
        print("please enter a number")

    else:
        print(f"thank you for number {number}")

def get_number():
    try:
        number = int(input("number: "))

    except:
        print("please enter a number")

    finally:
        print("thank you for reading this post")

1) obj is None
2) obj == None

class Example:
       def __eq__(self, _):
           return True 

e = Example()
print(e == None)
print(e is None)

تابع ماشینی هست که ورودی میگیره و تبدیل میکنه به خروجی. یعنی ماشین تبدیل کننده ورودی به خروجی.

def function_name(param1, param2, ...):
    ...

return value

function_name(value1, value2, ...)

result = function_name(value1, value2, ...)