لینک‌های مفید برای شرکت در مسابقه:

بعد از مسابقه در ساعت ۱۹ امروز وبیناری برای حل بخشی از سوالات مسابقه و پاسخگویی به سوالات شما تدارک دیده‌ایم که می‌توانید از طریق این لینک به رایگان ثبت‌نام نمایید.

در زمان مسابقه می‌توانید سوال‌های خود را از قسمت "سوال بپرسید" مطرح کنید.

نیما در شرکت *کدنویس‌گستران شرق به‌جز حسن* مشغول به کار است. او فردی مینیمالیست است و از کتاب‌خانه‌های بزرگ و پیچیده‌ی *PHP* متنفر است. در حال حاضر، تیم *کدنویس‌گستران شرق به‌جز حسن* از موتور قالب *Smarty* استفاده می‌کند. این موتور قالب از نظر نیما بسیار بزرگ و پیچیده است. او تصمیم گرفته تا موتور قالب ساده‌ای با نام *Smarties* بسازد تا در پروژه‌های بعدی‌شان از آن استفاده کنند. از شما می‌خواهیم *Smarties* را برای نیما پیاده‌سازی کنید. # جزئیات پروژه پروژه‌ی اولیه را از [این لینک](/contest/assignments/21628/download_problem_initial_project/74650/) دانلود کنید. ## اینترفیس `SmartiesFilter` *اسمارتیز* همانند سایر *template engine* ها امکان اعمال فیلتر روی مقادیر را داراست. البته، این فیلترها هیچ آرگومانی به‌جز مقدار فعلی ندارد. همه‌ی فیلترهای *اسمارتیز* اینترفیس `SmartiesFilter` را پیاده‌سازی می‌کنند. این اینترفیس تنها شامل متدی با نام `apply` است که متن ورودی را دریافت کرده و پس از اعمال تغییرات، متن نهایی را برمی‌گرداند. ```php interface SmartiesFilter { public function apply($text); } ``` ## کلاس `SmartiesFilterFactory` وظیفه‌ی این کلاس، تبدیل یک تابع به آبجکتی از `SmartiesFilter` است. این کلاس شامل متدی *static* به نام `create` است که یک تابع را به شکل نام تابع یا *anonymous function* دریافت کرده و یک آبجکت از نوع `SmartiesFilter` برمی‌گرداند که عملکرد متد `apply` آن دقیقاً مطابق با تابع ورودی است. اگر آرگومان ورودی نامعتبر بود (قابل فراخوانی نبود)، یک `InvalidArgumentException` با متن پیغام `filter must be callable` *throw* کنید. ```php class SmartiesFilterFactory { public static function create($filter) { // TODO: Implement } } ``` **توجه:** برای پیاده‌سازی متد `create`، مجاز به ایجاد کلاس جدید (کلاسی که *anonymous* نباشد) در برنامه نیستید. ## کلاس `Smarties` این کلاس، کلاس اصلی *اسمارتیز* است. این کلاس شامل متدهای زیر است: 1. متد `addFilter($name, $filter)`: این متد، یک فیلتر با نام `$name` را به فیلترها اضافه می‌کند. موارد زیر را برای پیاده‌سازی این متد در نظر داشته باشید: + اگر فیلتری با این نام از قبل موجود باشد، فیلتر جدید باید جایگزین فیلتر قبلی شود. اگر فیلتر ورودی از نوع `SmartiesFilter` نباشد، باید یک `InvalidArgumentException` با متن پیغام `filter must implement SmartiesFilter` *throw* کنید. + *اسمارتیز* نباید به کوچکی و بزرگی حروف در نام فیلترها حساس باشد. 2. متد `render($filepath, $parameters)`: این متد، نام فایل قالب ورودی و آرایه‌ای انجمنی از پارامترها دریافت می‌کند و رشته‌ی خروجی را برمی‌گرداند. موارد زیر را برای پیاده‌سازی این متد در نظر داشته باشید: + اگر فایل `$filepath` موجود نباشد، باید یک `Exception` با متن پیغام `input file not exist` *throw* کنید. + اگر پارامتری موجود نباشد، باید یک `Exception` با متن پیغام `parameter "$parameterName" not provided` *throw* کنید (`$parameterName` نام پارامتر است). + اگر فیلتری موجود نباشد، باید یک `Exception` با متن پیغام `filter "$filter" does not exist` *throw* کنید (`$filter` نام فیلتر است). + *اسمارتیز* نباید به کوچکی و بزرگی حروف در نام پارامترها حساس باشد. **تضمین می‌شود** که دو پارامتر نظیر `a` و `A` به‌صورت هم‌زمان به این متد داده نمی‌شود. پارامترها در قالب به‌صورت زیر نوشته می‌شوند: ``` {{ parameter_name }} ``` برای اعمال فیلتر نیز از کاراکتر `|` استفاده می‌شود. می‌توان یک یا چند فیلتر را بر روی یک پارامتر اعمال کرد: ``` {{ parameter1|uppercase }} {{ parameter2|reverse|uppercase }} ``` فیلترها باید به‌ترتیب از چپ به راست روی پارامتر اعمال شوند. ```php class Smarties { public function addFilter($name, $filter) { // TODO: Implement } public function render($filepath, $parameters) { // TODO: Implement } } ``` # مثال با اجرای اسکریپت `index.php` موجود در پروژه‌ی اولیه، خروجی باید به‌صورت زیر باشد: ```html <!DOCTYPE html> <html> <head> <title>sample</title> </head> <body> <p>WELCOME TO CODECUP!</p> </body> </html> ``` # آن‌چه باید آپلود کنید فایل‌های `Smarties.php` و `SmartiesFilterFactory` را *Zip* کرده و آپلود کنید.

اسمارتیز

نیما در شرکت کدنویس‌گستران شرق به‌جز حسن مشغول به کار است. او فردی مینیمالیست است و از کتاب‌خانه‌های بزرگ و پیچیده‌ی PHP متنفر است. در حال حاضر، تیم کدنویس‌گستران شرق به‌جز حسن از موتور قالب Smarty استفاده می‌کند. این موتور قالب از نظر نیما بسیار بزرگ و پیچیده است. او تصمیم گرفته تا موتور قالب ساده‌ای با نام Smarties بسازد تا در پروژه‌های بعدی‌شان از آن استفاده کنند.

از شما می‌خواهیم Smarties را برای نیما پیاده‌سازی کنید.

جزئیات پروژه🔗

پروژه‌ی اولیه را از این لینک دانلود کنید.

اینترفیس `SmartiesFilter`🔗

اسمارتیز همانند سایر template engine ها امکان اعمال فیلتر روی مقادیر را داراست. البته، این فیلترها هیچ آرگومانی به‌جز مقدار فعلی ندارد. همه‌ی فیلترهای اسمارتیز اینترفیس SmartiesFilter را پیاده‌سازی می‌کنند. این اینترفیس تنها شامل متدی با نام apply است که متن ورودی را دریافت کرده و پس از اعمال تغییرات، متن نهایی را برمی‌گرداند.

interface SmartiesFilter
{
    public function apply($text);
}

کلاس `SmartiesFilterFactory`🔗

وظیفه‌ی این کلاس، تبدیل یک تابع به آبجکتی از SmartiesFilter است. این کلاس شامل متدی static به نام create است که یک تابع را به شکل نام تابع یا anonymous function دریافت کرده و یک آبجکت از نوع SmartiesFilter برمی‌گرداند که عملکرد متد apply آن دقیقاً مطابق با تابع ورودی است.

اگر آرگومان ورودی نامعتبر بود (قابل فراخوانی نبود)، یک InvalidArgumentException با متن پیغام filter must be callable throw کنید.

class SmartiesFilterFactory
{
    public static function create($filter)
    {
        // TODO: Implement
    }
}

توجه: برای پیاده‌سازی متد create، مجاز به ایجاد کلاس جدید (کلاسی که anonymous نباشد) در برنامه نیستید.

کلاس `Smarties`🔗

این کلاس، کلاس اصلی اسمارتیز است. این کلاس شامل متدهای زیر است:

متد addFilter($name, $filter): این متد، یک فیلتر با نام $name را به فیلترها اضافه می‌کند. موارد زیر را برای پیاده‌سازی این متد در نظر داشته باشید:

اگر فیلتری با این نام از قبل موجود باشد، فیلتر جدید باید جایگزین فیلتر قبلی شود. اگر فیلتر ورودی از نوع SmartiesFilter نباشد، باید یک InvalidArgumentException با متن پیغام filter must implement SmartiesFilter throw کنید.
اسمارتیز نباید به کوچکی و بزرگی حروف در نام فیلترها حساس باشد.

متد render($filepath, $parameters): این متد، نام فایل قالب ورودی و آرایه‌ای انجمنی از پارامترها دریافت می‌کند و رشته‌ی خروجی را برمی‌گرداند. موارد زیر را برای پیاده‌سازی این متد در نظر داشته باشید:

اگر فایل $filepath موجود نباشد، باید یک Exception با متن پیغام input file not exist throw کنید.
اگر پارامتری موجود نباشد، باید یک Exception با متن پیغام parameter "$parameterName" not provided throw کنید ($parameterName نام پارامتر است).
اگر فیلتری موجود نباشد، باید یک Exception با متن پیغام filter "$filter" does not exist throw کنید ($filter نام فیلتر است).
اسمارتیز نباید به کوچکی و بزرگی حروف در نام پارامترها حساس باشد. تضمین می‌شود که دو پارامتر نظیر a و A به‌صورت هم‌زمان به این متد داده نمی‌شود.

پارامترها در قالب به‌صورت زیر نوشته می‌شوند:

{{ parameter_name }}

برای اعمال فیلتر نیز از کاراکتر | استفاده می‌شود. می‌توان یک یا چند فیلتر را بر روی یک پارامتر اعمال کرد:

{{ parameter1|uppercase }}
{{ parameter2|reverse|uppercase }}

فیلترها باید به‌ترتیب از چپ به راست روی پارامتر اعمال شوند.

class Smarties
{
    public function addFilter($name, $filter)
    {
        // TODO: Implement
    }

    public function render($filepath, $parameters)
    {
        // TODO: Implement
    }
}

مثال🔗

با اجرای اسکریپت index.php موجود در پروژه‌ی اولیه، خروجی باید به‌صورت زیر باشد:

<!DOCTYPE html>
<html>
<head>
  <title>sample</title>
</head>
<body>
  <p>WELCOME TO CODECUP!</p>
</body>
</html>

آن‌چه باید آپلود کنید🔗

فایل‌های Smarties.php و SmartiesFilterFactory را Zip کرده و آپلود کنید.

ارسال پاسخ برای این سؤال

در حال حاضر شما دسترسی ندارید.

حل سؤال در بانک سؤالات