المزخرف هو دالة تلف دالة أخرى لإضافة سلوك دون تعديل كود الأصلي. يتم تطبيقه باستخدام بناء الجملة @decorator فوق دالة — طريقة نظيفة لإضافة مخاوف عابرة مثل التسجيل (logging) والحساب الزمني (timing) والتخزين المؤقت (caching) وتحكم الوصول.
():
():
()
result = func(*args, **kwargs)
()
result
wrapper
():
()
greet()
بناء الجملة @my_decorator هو سكر نحوي لـ greet = my_decorator(greet) — يستبدل greet بـ wrapper، والذي ينفذ كود إضافي حول الاستدعاء الأصلي. يجعل *args, **kwargs المزخرف يعمل مع أي توقيع دالة.
import time, functools
def timed(func):
@functools.wraps(func) # preserves func's name/docstring (important!)
def wrapper(*args, **kwargs):
start = time.perf_counter()
result = func(*args, **kwargs)
print(f"{func.__name__} took {time.perf_counter() - start:.3f}s")
return result
return wrapper
@timed
def slow_task():
time.sleep(1)
@functools.wraps(func) مهم — بدونه، الدالة المغلفة تفقد اسمها الأصلي و docstring.
def repeat(times): # outer takes the decorator's argument
def decorator(func):
@functools.wraps(func)
def wrapper(*args, **kwargs):
for _ in range(times):
func(*args, **kwargs)
return wrapper
return decorator
@repeat(times=3)
def hello(): print("hi") # prints "hi" three times
مزخرف معامل يحتاج إلى طبقة إضافية (دالة تُرجع مزخرف).
@property → turn a method into a computed attribute
@staticmethod / @classmethod → method types
@functools.lru_cache → memoize results
@app.route("/") → web framework routing (Flask)
@pytest.fixture → test fixtures
المزخرفات ميزة قوية ومميزة في Python لـ إضافة سلوك قابل لإعادة الاستخدام (التسجيل والحساب الزمني والتخزين المؤقت والمصادقة والتحقق والتوجيه) إلى الدوال بنظافة وبشكل تعريفي — فصل المخاوف العابرة عن المنطق الأساسي.
هي في كل مكان في Python الحقيقي: أطر العمل (frameworks) (@app.route)، والتخزين المؤقت (@lru_cache)، والفئات (@property)، والاختبار.
فهم كيفية كتابتها (دالة wrapper، *args/**kwargs، functools.wraps) والشكل المعامل يسمح لك باستخدام مزخرفات النظام البيئي بشكل صحيح وبناء التجريدات القابلة لإعادة الاستخدام الخاصة بك.