در دنیای برنامه‌نویسی پایتون، دکوراتورها ابزارهای قدرتمندی هستند که امکان افزودن قابلیت‌های جدید به توابع را بدون تغییر در کد اصلی آنها فراهم می‌کنند. با این حال، استفاده از دکوراتورها می‌تواند برخی از مشخصات اصلی تابع را تغییر دهد، مانند نام تابع و مستندات آن. دکوراتور @wraps که در ماژول functools تعبیه شده، راه‌حلی برای حفظ این مشخصات ارائه می‌دهد.
برای درک بهتر این موضوع، ابتدا باید با مفهوم دکوراتورها در پایتون آشنا شویم. دکوراتورها توابعی هستند که توابع دیگر را به عنوان ورودی می‌پذیرند، برخی عملیات را بر روی آنها اجرا می‌کنند، و سپس یک تابع جدید باز می‌گردانند. این فرآیند اجازه می‌دهد تا رفتار توابع را به شکلی انعطاف‌پذیر توسعه دهیم یا تغییر دهیم.
زمانی که یک تابع با استفاده از دکوراتور تزئین می‌شود، متادیتای آن تابع می‌تواند تغییر کند. به عنوان مثال، اگر اطلاعات مربوط به نام تابع یا مستندات آن (docstring) نیاز داشته باشیم، ممکن است با تغییراتی ناخواسته مواجه شویم. این مسئله می‌تواند خوانایی کد را کاهش دهد و درک صحیح از عملکرد تابع را دشوار کند.
@wraps در حل این مشکلدکوراتور @wraps که از ماژول functools فراخوانی می‌شود، به ما این امکان را می‌دهد که متادیتای تابع اصلی را در تابع جدید حفظ کنیم. این کار با استفاده از یک wrapper تابع انجام می‌شود که تمام مشخصات تابع اصلی را کپی می‌کند. بنابراین، حتی پس از اعمال دکوراتور، می‌توان به نام تابع، مستندات، و سایر متادیتاها دسترسی داشت.
@wrapsاستفاده از @wraps بسیار ساده است. کافی است پیش از تعریف تابع wrapper در دکوراتور خود، این دکوراتور را اعمال کنید. این کار موجب می‌شود که تمام اطلاعات مربوط به تابع اصلی، مانند __name__ و __doc__، به درستی حفظ شوند.
@wrapsدکوراتور @wraps یک ابزار کوچک اما قدرتمند در پایتون است که امکان حفظ شفافیت و منظم‌سازی کد را حتی در حین استفاده از دکوراتورها فراهم می‌کند. این ویژگی از آن جهت اهمیت دارد که متادیتای توابع بخشی جدایی‌ناپذیر از خوانایی و قابلیت نگهداری کد در طولانی مدت است.
