المعاملات المتقدمة والنطاق

def greet(name, greeting="Hello"):
    print(f"{greeting}, {name}!")

greet("Alice")              # Hello, Alice!
greet("Bob", "Hi")          # Hi, Bob!
greet("Charlie", "Hey")     # Hey, Charlie!

def add_item(item, items=[]):   # ❌ خطير!
    items.append(item)
    return items

print(add_item("apple"))     # ['apple']
print(add_item("banana"))    # ['apple', 'banana'] — وليس ['banana']!
print(add_item("orange"))    # ['apple', 'banana', 'orange']

def add_item(item, items=None):  # ✅ آمن
    if items is None:
        items = []
    items.append(item)
    return items

print(add_item("apple"))     # ['apple']
print(add_item("banana"))    # ['banana']
print(add_item("orange"))    # ['orange']

def create_user(name, age, city):
    print(f"User: {name}, {age} years old, from {city}")

# الوسائط الموضعية — يجب أن تكون بالترتيب
create_user("Alice", 25, "Beijing")

# الوسائط المفتاحية — حدد أسماء المعاملات، الترتيب لا يهم
create_user(age=30, city="Shanghai", name="Bob")
create_user(name="Charlie", city="Guangzhou", age=22)

# مختلطة — موضعية أولاً، مفتاحية ثانياً
create_user("Diana", city="Shenzhen", age=28)
# create_user(name="Eve", 35, "Chengdu")   ❌ الوسائط المفتاحية لا يمكن أن تسبق الموضعية

def sum_all(*numbers):
    """تقبل أي عدد من الأرقام وتُرجع مجموعها"""
    total = 0
    for n in numbers:
        total += n
    return total

print(sum_all(1, 2))                # 3
print(sum_all(1, 2, 3, 4, 5))      # 15
print(sum_all())                    # 0 — بدون وسائط أيضاً تعمل

def show_args(*args):
    print(f"Received {len(args)} arguments: {args}")
    for i, arg in enumerate(args, 1):
        print(f"  #{i}: {arg}")

show_args("apple", "banana", "orange")

def create_profile(**info):
    """أنشئ ملف تعريف مستخدم، يقبل أي قدر من المعلومات"""
    print("User Profile:")
    for key, value in info.items():
        print(f"  {key}: {value}")

create_profile(name="Alice", age=25, city="Beijing", job="Engineer")

User Profile:
  name: Alice
  age: 25
  city: Beijing
  job: Engineer

def advanced_function(a, b, *args, **kwargs):
    print(f"Positional: a={a}, b={b}")
    print(f"Extra positional: {args}")
    print(f"Keyword: {kwargs}")

advanced_function(1, 2, 3, 4, 5, name="Alice", age=25)
# Positional: a=1, b=2
# Extra positional: (3, 4, 5)
# Keyword: {'name': 'Alice', 'age': 25}

# نطاق عالمي
x = 10          # متغير عالمي

def outer():
    # نطاق الدالة المحيطة
    x = 20      # هذا هو x المحلي لـ outer، مختلف عن x العالمي
    
    def inner():
        # نطاق محلي
        x = 30  # هذا هو x المحلي لـ inner
        print(f"inner: {x}")     # 30
    
    inner()
    print(f"outer: {x}")         # 20

outer()
print(f"global: {x}")            # 10

count = 0

def increment():
    global count     # أعلن عن نية تعديل المتغير العالمي
    count += 1

increment()
increment()
print(count)         # 2

def factorial(n):
    """احسب n! (مضروب n)"""
    if n <= 1:
        return 1          # شرط الإنهاء
    return n * factorial(n - 1)   # استدعاء عودي

print(factorial(5))        # 120 (5×4×3×2×1)

factorial(5) = 5 * factorial(4)
             = 5 * 4 * factorial(3)
             = 5 * 4 * 3 * factorial(2)
             = 5 * 4 * 3 * 2 * factorial(1)
             = 5 * 4 * 3 * 2 * 1
             = 120

def fibonacci(n):
    """أرجع رقم فيبوناتشي رقم n (بدءاً من 0)"""
    if n <= 1:
        return n
    return fibonacci(n - 1) + fibonacci(n - 2)

# اطبع أول 10
for i in range(10):
    print(fibonacci(i), end=" ")
# يُخرج: 0 1 1 2 3 5 8 13 21 34