## Formatter


تنسيق النصوص باستخدام القوالب.


الاستخدام

``` python
Formatter(
    left_delim="{{", right_delim="}}",
    auto_escape=True,
)
```


يدعم استبدال العناصر النائبة، وترميز HTML، وفواصل قابلة للتخصيص.


## المعلمات


`left_delim: str = ``"{{"`  
الفاصل الأيسر للعناصر النائبة.

`right_delim: str = ``"}}"`  
الفاصل الأيمن للعناصر النائبة.

`auto_escape: bool = ``True`  
ترميز HTML تلقائياً للقيم المستبدلة.


## انظر أيضًا

[format_text()](format_text.md#gdtest_i18n_arabic.format_text) تغليف النص بعرض سطر محدد.  

[escape_html()](escape_html.md#gdtest_i18n_arabic.escape_html) ترميز الأحرف الخاصة في HTML.  


## أمثلة

``` python
>>> fmt = Formatter(left_delim="{{", right_delim="}}")
>>> fmt.render("مرحباً {{name}}!", name="World")
```

'مرحباً World!'

> **Note: أُضيف في الإصدار 0.1.0**


## الطرق

| Name | Description |
|----|----|
| [list_placeholders()](#list_placeholders) | استخراج أسماء العناصر النائبة من القالب. |
| [render()](#render) | عرض القالب بالقيم المعطاة. |

------------------------------------------------------------------------


#### list_placeholders()


استخراج أسماء العناصر النائبة من القالب.


الاستخدام

``` python
list_placeholders(template)
```


##### المعلمات


`template: str`  
القالب المراد فحصه.


##### القيم المُعادة


`list[str]`  
قائمة بأسماء العناصر النائبة الموجودة.


------------------------------------------------------------------------


#### render()


عرض القالب بالقيم المعطاة.


الاستخدام

``` python
render(template, **kwargs)
```


##### المعلمات


`template: str`  
نص القالب.

`**kwargs: str`  
القيم المسماة للاستبدال.


##### القيم المُعادة


`str`  
النص المعروض.