# التسجيل

🤗 يحتوي Diffusers على نظام تسجيل مركزي يسهّل إدارة مستوى التفصيل في المكتبة. يتم ضبط مستوى التفصيل الافتراضي على `WARNING`.

لتغيير مستوى التفصيل، استخدم أحد الإعدادات المباشرة. على سبيل المثال، لتغيير مستوى التفصيل إلى مستوى `INFO`.

```python
import diffusers

diffusers.logging.set_verbosity_info()
```

يمكنك أيضًا استخدام متغير البيئة `DIFFUSERS_VERBOSITY` لتجاوز مستوى التفصيل الافتراضي. يمكنك ضبطه على أحد الخيارات التالية: `debug`، `info`، `warning`، `error`، `critical`. على سبيل المثال:

```bash
DIFFUSERS_VERBOSITY=error ./myprogram.py
```

بالإضافة إلى ذلك، يمكن تعطيل بعض `warnings` عن طريق تعيين متغير البيئة `DIFFUSERS_NO_ADVISORY_WARNINGS` إلى قيمة صحيحة، مثل `1`. يؤدي هذا إلى تعطيل أي تحذير يُسجَّل بواسطة `logger.warning_advice`. على سبيل المثال:

```bash
DIFFUSERS_NO_ADVISORY_WARNINGS=1 ./myprogram.py
```

فيما يلي مثال على كيفية استخدام نفس السجّال الذي تستخدمه المكتبة في وحدة أو سكربت خاص بك:

```python
from diffusers.utils import logging

logging.set_verbosity_info()
logger = logging.get_logger("diffusers")
logger.info("INFO")
logger.warning("WARN")
```

جميع طرق وحدة التسجيل موثقة أدناه. الطرق الرئيسية هي `logging.get_verbosity` للحصول على مستوى التفصيل الحالي في السجل، و`logging.set_verbosity` لضبط مستوى التفصيل إلى المستوى الذي تختاره.

بترتيب من الأقل تفصيلاً إلى الأكثر تفصيلاً:

|                                                    الطريقة | قيمة عدد صحيح |                                         الوصف |
|----------------------------------------------------------:|--------------:|----------------------------------------------------:|
| `diffusers.logging.CRITICAL` أو `diffusers.logging.FATAL` |            50 |                الإبلاغ عن الأخطاء الأكثر أهمية فقط |
|                                 `diffusers.logging.ERROR` |            40 |                                  الإبلاغ عن الأخطاء فقط |
|   `diffusers.logging.WARNING` أو `diffusers.logging.WARN` |            30 |           الإبلاغ عن الأخطاء والتحذيرات فقط (الافتراضي) |
|                                  `diffusers.logging.INFO` |            20 | الإبلاغ عن الأخطاء والتحذيرات والمعلومات الأساسية فقط |
|                                 `diffusers.logging.DEBUG` |            10 |                              تقرير جميع المعلومات |

افتراضيًا، تُعرض أشرطة تقدم `tqdm` أثناء تنزيل النموذج. تُستخدم `logging.disable_progress_bar` و`logging.enable_progress_bar` لتفعيل أو تعطيل هذا السلوك.

## المُعيّنات الأساسية[[diffusers.utils.logging.set_verbosity_error]]

#### diffusers.utils.logging.set_verbosity_error[[diffusers.utils.logging.set_verbosity_error]]

```python
diffusers.utils.logging.set_verbosity_error()
```

[المصدر](https://github.com/huggingface/diffusers/blob/main/src/diffusers/utils/logging.py#L201)

اضبط مستوى التفصيل على مستوى `ERROR`.

#### diffusers.utils.logging.set_verbosity_warning[[diffusers.utils.logging.set_verbosity_warning]]

```python
diffusers.utils.logging.set_verbosity_warning()
```

[المصدر](https://github.com/huggingface/diffusers/blob/main/src/diffusers/utils/logging.py#L191)

اضبط مستوى التفصيل على مستوى `WARNING`.

#### diffusers.utils.logging.set_verbosity_info[[diffusers.utils.logging.set_verbosity_info]]

```python
diffusers.utils.logging.set_verbosity_info()
```

[المصدر](https://github.com/huggingface/diffusers/blob/main/src/diffusers/utils/logging.py#L186)

اضبط مستوى التفصيل على مستوى `INFO`.

#### diffusers.utils.logging.set_verbosity_debug[[diffusers.utils.logging.set_verbosity_debug]]

```python
diffusers.utils.logging.set_verbosity_debug()
```

[المصدر](https://github.com/huggingface/diffusers/blob/main/src/diffusers/utils/logging.py#L196)

اضبط مستوى التفصيل على مستوى `DEBUG`.

## دوال أخرى[[diffusers.utils.logging.get_verbosity]]

#### diffusers.utils.logging.get_verbosity[[diffusers.utils.logging.get_verbosity]]

```python
diffusers.utils.logging.get_verbosity()
```

[المصدر](https://github.com/huggingface/diffusers/blob/main/src/diffusers/utils/logging.py#L147)

**يعيد:** `int`

أعداد مستويات التسجيل التي يمكن أن تكون أحد ما يلي:

- `50`: `diffusers.logging.CRITICAL` أو `diffusers.logging.FATAL`
- `40`: `diffusers.logging.ERROR`
- `30`: `diffusers.logging.WARNING` أو `diffusers.logging.WARN`
- `20`: `diffusers.logging.INFO`
- `10`: `diffusers.logging.DEBUG`

أعد المستوى الحالي لسجل الجذر الخاص بـ 🤗 Diffusers على شكل `int`.

#### diffusers.utils.logging.set_verbosity[[diffusers.utils.logging.set_verbosity]]

```python
diffusers.utils.logging.set_verbosity(verbosity: int)
```

[المصدر](https://github.com/huggingface/diffusers/blob/main/src/diffusers/utils/logging.py#L167)

**المعاملات:**

verbosity (`int`) : مستوى التسجيل الذي يمكن أن يكون أحد ما يلي: - `diffusers.logging.CRITICAL` أو `diffusers.logging.FATAL` - `diffusers.logging.ERROR` - `diffusers.logging.WARNING` أو `diffusers.logging.WARN` - `diffusers.logging.INFO` - `diffusers.logging.DEBUG`

اضبط مستوى التفصيل لسجل الجذر الخاص بـ 🤗 Diffusers.

#### diffusers.utils.get_logger[[diffusers.utils.get_logger]]

```python
diffusers.utils.get_logger(name: str | None = None)
```

[المصدر](https://github.com/huggingface/diffusers/blob/main/src/diffusers/utils/logging.py#L131)

إرجاع مسجّل (logger) بالاسم المحدد.

لا يُفترض الوصول إلى هذه الدالة مباشرةً ما لم تكن تكتب وحدة مخصصة لـ diffusers.

#### diffusers.utils.logging.enable_default_handler[[diffusers.utils.logging.enable_default_handler]]

```python
diffusers.utils.logging.enable_default_handler()
```

[المصدر](https://github.com/huggingface/diffusers/blob/main/src/diffusers/utils/logging.py#L215)

فعّل المُعالِج الافتراضي لسجّال الجذر الخاص بـ 🤗 Diffusers.

#### diffusers.utils.logging.disable_default_handler[[diffusers.utils.logging.disable_default_handler]]

```python
diffusers.utils.logging.disable_default_handler()
```

[المصدر](https://github.com/huggingface/diffusers/blob/main/src/diffusers/utils/logging.py#L206)

تعطيل المُعالِج الافتراضي لسجّان الجذر الخاص بـ 🤗 Diffusers.

#### diffusers.utils.logging.enable_explicit_format[[diffusers.utils.logging.enable_explicit_format]]

```python
diffusers.utils.logging.enable_explicit_format()
```

[المصدر](https://github.com/huggingface/diffusers/blob/main/src/diffusers/utils/logging.py#L261)

enable_explicit_format لتفعيل التنسيق الصريح لكل مسجّل في 🤗 Diffusers. التنسيق الصريح هو على النحو التالي:
```
[LEVELNAME|FILENAME|LINE NUMBER] TIME >> MESSAGE
```

تتأثر جميع المعالجات المرتبطة حاليًا بسجّال الجذر (root logger) بهذه الطريقة.

#### diffusers.utils.logging.reset_format[[diffusers.utils.logging.reset_format]]

```python
diffusers.utils.logging.reset_format()
```

[المصدر](https://github.com/huggingface/diffusers/blob/main/src/diffusers/utils/logging.py#L276)

يعيد تعيين تنسيق مسجلات 🤗 Diffusers.

تتأثر جميع المعالجات المرتبطة حاليًا بسجّال الجذر (root logger) بهذه الطريقة.

#### diffusers.utils.logging.enable_progress_bar[[diffusers.utils.logging.enable_progress_bar]]

```python
diffusers.utils.logging.enable_progress_bar()
```

[المصدر](https://github.com/huggingface/diffusers/blob/main/src/diffusers/utils/logging.py#L352)

تفعيل شريط تقدم tqdm.

#### diffusers.utils.logging.disable_progress_bar[[diffusers.utils.logging.disable_progress_bar]]

```python
diffusers.utils.logging.disable_progress_bar()
```

[المصدر](https://github.com/huggingface/diffusers/blob/main/src/diffusers/utils/logging.py#L358)

تعطيل شريط تقدم tqdm.