# أدوات

## إعداد التسجيل[[datasets.utils.logging.get_verbosity]]

🤗 تسعى مكتبة Datasets إلى أن تكون شفافة وصريحة بشأن طريقة عملها، لكن هذا قد يكون مفصّلًا بشكل مفرط في بعض الأحيان. لقد أضفنا سلسلة من طرق التسجيل التي تتيح لك ضبط مستوى التفصيل في المكتبة بأكملها بسهولة. حاليًا، يتم ضبط مستوى التفصيل الافتراضي للمكتبة على `WARNING`.

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

```py
import datasets
datasets.logging.set_verbosity_info()
```

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

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

جميع طرق وحدة التسجيل هذه موثقة أدناه. أهمها هي:

- [logging.get_verbosity()](/docs/datasets/v5.2.0/ar/package_reference/utilities#datasets.utils.logging.get_verbosity) للحصول على مستوى التفصيل الحالي في السجل
- [logging.set_verbosity()](/docs/datasets/v5.2.0/ar/package_reference/utilities#datasets.utils.logging.set_verbosity) لضبط مستوى التفصيل إلى المستوى الذي تختاره

بترتيب من الأقل إلى الأكثر تفصيلاً (مع قيم `int` المقابلة لها):

1. `logging.CRITICAL` أو `logging.FATAL` (قيمة عددية، 50): الإبلاغ عن الأخطاء الأكثر حرجًا فقط.
2. `logging.ERROR` (قيمة عددية، 40): الإبلاغ عن الأخطاء فقط.
3. `logging.WARNING` أو `logging.WARN` (قيمة عددية، 30): يُبلّغ عن الأخطاء والتحذيرات فقط. هذا هو المستوى الافتراضي الذي تستخدمه المكتبة.
4. `logging.INFO` (قيمة عددية، 20): يُبلغ عن الأخطاء والتنبيهات والمعلومات الأساسية.
5. `logging.DEBUG` (قيمة عددية، 10): الإبلاغ عن جميع المعلومات.

#### datasets.utils.logging.get_verbosity[[datasets.utils.logging.get_verbosity]]

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

[المصدر](https://github.com/huggingface/datasets/blob/5.2.0/src/datasets/utils/logging.py#L94)

**يعيد:**

مستوى التسجيل، على سبيل المثال `datasets.logging.DEBUG` و`datasets.logging.INFO`.

إرجاع المستوى الحالي لسجل الجذر الخاص بمكتبة HuggingFace datasets.

> [!TIP]
> تتضمن مكتبة HuggingFace datasets المستويات التالية للتسجيل: - `datasets.logging.CRITICAL`، `datasets.logging.FATAL` - `datasets.logging.ERROR` - `datasets.logging.WARNING`، `datasets.logging.WARN` - `datasets.logging.INFO` - `datasets.logging.DEBUG`

#### datasets.utils.logging.set_verbosity[[datasets.utils.logging.set_verbosity]]

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

[المصدر](https://github.com/huggingface/datasets/blob/5.2.0/src/datasets/utils/logging.py#L110)

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

verbosity : مستوى التسجيل، على سبيل المثال `datasets.logging.DEBUG` و`datasets.logging.INFO`.

اضبط مستوى المسجّل الجذري (root logger) لمكتبة Hugging Face Datasets.

#### datasets.utils.logging.set_verbosity_info[[datasets.utils.logging.set_verbosity_info]]

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

[المصدر](https://github.com/huggingface/datasets/blob/5.2.0/src/datasets/utils/logging.py#L119)

اضبط مستوى المسجّل الجذري (root logger) لمكتبة Hugging Face datasets على `INFO`.

ستعرض هذه العملية معظم معلومات التسجيل وأشرطة tqdm.

اختصار لـ `datasets.logging.set_verbosity(datasets.logging.INFO)`.

#### datasets.utils.logging.set_verbosity_warning[[datasets.utils.logging.set_verbosity_warning]]

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

[المصدر](https://github.com/huggingface/datasets/blob/5.2.0/src/datasets/utils/logging.py#L129)

اضبط مستوى المسجّل الجذري (root logger) لمكتبة Hugging Face datasets على `WARNING`.

ستعرض هذه الجملة معلومات تسجيل التنبيهات والأخطاء وأشرطة tqdm فقط.

اختصار لـ `datasets.logging.set_verbosity(datasets.logging.WARNING)`.

#### datasets.utils.logging.set_verbosity_debug[[datasets.utils.logging.set_verbosity_debug]]

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

[المصدر](https://github.com/huggingface/datasets/blob/5.2.0/src/datasets/utils/logging.py#L139)

اضبط مستوى المسجّل الجذري (root logger) لمكتبة Hugging Face datasets على `DEBUG`.

ستعرض هذه الجملة جميع معلومات التسجيل وأشرطة tqdm.

اختصار لـ `datasets.logging.set_verbosity(datasets.logging.DEBUG)`.

#### datasets.utils.logging.set_verbosity_error[[datasets.utils.logging.set_verbosity_error]]

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

[المصدر](https://github.com/huggingface/datasets/blob/5.2.0/src/datasets/utils/logging.py#L149)

اضبط مستوى المسجّل الجذري (root logger) لمكتبة Hugging Face datasets على `ERROR`.

ستعرض هذه الجملة معلومات تسجيل الأخطاء وأشرطة tqdm فقط.

اختصار لـ `datasets.logging.set_verbosity(datasets.logging.ERROR)`.

#### datasets.utils.logging.disable_propagation[[datasets.utils.logging.disable_propagation]]

```python
datasets.utils.logging.disable_propagation()
```

[المصدر](https://github.com/huggingface/datasets/blob/5.2.0/src/datasets/utils/logging.py#L159)

تعطيل انتشار مخرجات سجلات المكتبة. لاحظ أن انتشار السجلات معطّل افتراضيًا.

#### datasets.utils.logging.enable_propagation[[datasets.utils.logging.enable_propagation]]

```python
datasets.utils.logging.enable_propagation()
```

[المصدر](https://github.com/huggingface/datasets/blob/5.2.0/src/datasets/utils/logging.py#L166)

تفعيل انتشار مخرجات سجلات المكتبة. يُرجى تعطيل المُعالِج الافتراضي لمكتبة Hugging Face datasets لمنع تسجيل السجلات مرتين إذا تم تكوين المُسجِّل الجذري.

## تهيئة أشرطة التقدم[[datasets.enable_progress_bars]]

بشكل افتراضي، ستظهر أشرطة تقدم `tqdm` أثناء تنزيل مجموعة البيانات ومعالجتها مسبقاً. يمكنك تعطيلها على مستوى النظام عن طريق تعيين متغير البيئة `HF_DATASETS_DISABLE_PROGRESS_BARS`. كما يمكنك تفعيلها/تعطيلها باستخدام [enable_progress_bars()](/docs/datasets/v5.2.0/ar/package_reference/utilities#datasets.enable_progress_bars) و [disable_progress_bars()](/docs/datasets/v5.2.0/ar/package_reference/utilities#datasets.disable_progress_bars). إذا تم تعيين متغير البيئة، فإن له الأولوية على الدوال المساعدة.

#### datasets.enable_progress_bars[[datasets.enable_progress_bars]]

```python
datasets.enable_progress_bars()
```

[المصدر](https://github.com/huggingface/datasets/blob/5.2.0/src/datasets/utils/tqdm.py#L78)

تفعيل أشرطة التقدم المستخدمة في `datasets` على مستوى النظام، ما لم يتم تعيين متغير البيئة `HF_DATASETS_DISABLE_PROGRESS_BARS`.

استخدم [disable_progress_bars()](/docs/datasets/v5.2.0/ar/package_reference/utilities#datasets.disable_progress_bars) لتعطيلها.

#### datasets.disable_progress_bars[[datasets.disable_progress_bars]]

```python
datasets.disable_progress_bars()
```

[المصدر](https://github.com/huggingface/datasets/blob/5.2.0/src/datasets/utils/tqdm.py#L61)

تعطيل أشرطة التقدم المستخدمة في `datasets` على مستوى النظام، ما لم يتم تعيين متغير البيئة `HF_DATASETS_DISABLE_PROGRESS_BARS`.

استخدم [enable_progress_bars()](/docs/datasets/v5.2.0/ar/package_reference/utilities#datasets.enable_progress_bars) لإعادة تفعيلها.

#### datasets.are_progress_bars_disabled[[datasets.are_progress_bars_disabled]]

```python
datasets.are_progress_bars_disabled()
```

[المصدر](https://github.com/huggingface/datasets/blob/5.2.0/src/datasets/utils/tqdm.py#L95)

يعيد ما إذا كانت أشرطة التقدم معطّلة على مستوى النظام أم لا.

يمكن تمكين أشرطة التقدم المستخدمة في `datasets` أو تعطيلها على مستوى النظام باستخدام [enable_progress_bars()](/docs/datasets/v5.2.0/ar/package_reference/utilities#datasets.enable_progress_bars) و [disable_progress_bars()](/docs/datasets/v5.2.0/ar/package_reference/utilities#datasets.disable_progress_bars) أو عن طريق تعيين `HF_DATASETS_DISABLE_PROGRESS_BARS` كمتغير بيئة.