المكرّرات والمولّدات

# جميع الحاويات قابلة للتكرار
print(hasattr([1, 2, 3], "__iter__"))     # True
print(hasattr("abc", "__iter__"))          # True
print(hasattr(100, "__iter__"))            # False — الأرقام غير قابلة للتكرار

# عملية التكرار اليدوية
numbers = [1, 2, 3]
iterator = iter(numbers)     # احصل على مكرّر

print(next(iterator))        # 1
print(next(iterator))        # 2
print(next(iterator))        # 3
# print(next(iterator))      # StopIteration — اكتمل التكرار

numbers = [1, 2, 3]
it = iter(numbers)
while True:
    try:
        value = next(it)
        print(value)
    except StopIteration:
        break

class Countdown:
    """مكرّر العد التنازلي"""
    def __init__(self, start):
        self.current = start
    
    def __iter__(self):
        return self                     # المكرّر يُرجع نفسه
    
    def __next__(self):
        if self.current <= 0:
            raise StopIteration         # أوقف التكرار
        value = self.current
        self.current -= 1
        return value

# الاستخدام
for i in Countdown(5):
    print(i, end=" ")                   # 5 4 3 2 1

class Fibonacci:
    """مكرّر فيبوناتشي — يُنشئ أول N أرقام"""
    def __init__(self, count):
        self.count = count
        self.index = 0
        self.a, self.b = 0, 1
    
    def __iter__(self):
        return self
    
    def __next__(self):
        if self.index >= self.count:
            raise StopIteration
        self.index += 1
        result = self.a
        self.a, self.b = self.b, self.a + self.b
        return result

for num in Fibonacci(10):
    print(num, end=" ")                 # 0 1 1 2 3 5 8 13 21 34

def countdown(start):
    """مولّد العد التنازلي"""
    while start > 0:
        yield start
        start -= 1

# الاستخدام
for i in countdown(5):
    print(i, end=" ")                   # 5 4 3 2 1

# نفس فيبوناتشي — باستخدام yield، أكثر إيجازاً بكثير من فئة المكرّر
def fibonacci(count):
    a, b = 0, 1
    for _ in range(count):
        yield a
        a, b = b, a + b

for num in fibonacci(10):
    print(num, end=" ")                 # 0 1 1 2 3 5 8 13 21 34

def generate_numbers():
    """محاكاة توليد الأرقام واحداً تلو الآخر"""
    print("Generating 1")
    yield 1
    print("Generating 2")
    yield 2
    print("Generating 3")
    yield 3

gen = generate_numbers()
print("Generator created, but not yet executed")

print(next(gen))    # Generating 1 \n 1
print(next(gen))    # Generating 2 \n 2
print(next(gen))    # Generating 3 \n 3

# طريقة "كسولة" لمعالجة الملفات الكبيرة
def read_large_file(filename):
    """اقرأ ملفاً كبيراً سطراً بسطر، دون تحميله كله في الذاكرة"""
    with open(filename, "r", encoding="utf-8") as f:
        for line in f:
            yield line.strip()

# معالجة بالمولّد — سطر واحد فقط في الذاكرة في كل مرة
for line in read_large_file("huge_log.txt"):
    if "ERROR" in line:
        print(line)  # السرعة محدودة فقط بسرعة قراءة القرص

# شاملة قائمة — تُنشئ جميع البيانات مرة واحدة
squares_list = [x ** 2 for x in range(1000000)]
print(f"List size: {len(squares_list)}")           # 1000000 (تستهلك ذاكرة)

# تعبير مولّد — عند الطلب
squares_gen = (x ** 2 for x in range(1000000))
print(f"Generator: {squares_gen}")                 # كائن مولّد (لا يستهلك ذاكرة تقريباً)

# نفس الاستخدام — حلقة for
for i, val in enumerate(squares_gen):
    if i >= 5:
        break
    print(val, end=" ")                            # 0 1 4 9 16