# أدوات مساعدة للخطوط

تُدرج هذه الصفحة جميع دوال الأداة التي يوفرها المكتبة للأنابيب.

لا تُفيد معظم تلك العناصر إلا إذا كنت تدرس كود النماذج الموجودة في المكتبة.

## معالجة الحُجج[[transformers.pipelines.ArgumentHandler]]

#### transformers.pipelines.ArgumentHandler[[transformers.pipelines.ArgumentHandler]]

```python
transformers.pipelines.ArgumentHandler()
```

[المصدر](https://github.com/huggingface/transformers/blob/main/src/transformers/pipelines/base.py#L388)

الواجهة الأساسية للتعامل مع الحُجج لكل [Pipeline](/docs/transformers/main/ar/main_classes/pipelines#transformers.Pipeline).

#### transformers.pipelines.ZeroShotClassificationArgumentHandler[[transformers.pipelines.ZeroShotClassificationArgumentHandler]]

```python
transformers.pipelines.ZeroShotClassificationArgumentHandler()
```

[المصدر](https://github.com/huggingface/transformers/blob/main/src/transformers/pipelines/zero_shot_classification.py#L13)

يتعامل مع الحُجج الخاصة بتصنيف النصوص بدون تدريب مسبق من خلال تحويل كل تسمية محتملة إلى زوج فرض/فرضية لنموذج الاستدلال اللغوي الطبيعي (NLI).

## تنسيق البيانات[[transformers.PipelineDataFormat]]

#### transformers.PipelineDataFormat[[transformers.PipelineDataFormat]]

```python
transformers.PipelineDataFormat(output_path: str | None, input_path: str | None, column: str | None, overwrite: bool = False)
```

[المصدر](https://github.com/huggingface/transformers/blob/main/src/transformers/pipelines/base.py#L398)

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

output_path (`str`) : مكان حفظ البيانات الصادرة.

input_path (`str`) : المكان الذي يجب البحث فيه عن البيانات المدخلة.

column (`str`) : العمود الذي يجب قراءته.

overwrite (`bool`، *اختياري*، القيمة الافتراضية `False`) : ما إذا كان سيتم تجاوز `output_path` أم لا.

الفئة الأساسية لجميع صيغ البيانات المدعومة في خط المعالجة، سواء للقراءة أو الكتابة. وتشمل صيغ البيانات المدعومة حاليًا:

- JSON
- CSV
- stdin/stdout (أنبوب)

يتضمن `PipelineDataFormat` أيضًا بعض الأدوات المساعدة للتعامل مع الأعمدة المتعددة، مثل تعيين أعمدة مجموعات البيانات إلى معاملات الكلمات المفتاحية في خطوط الأنابيب عبر صيغة `dataset_kwarg_1=dataset_column_1`.

#### from_str[[transformers.PipelineDataFormat.from_str]]

```python
from_str(format: str, output_path: str | None, input_path: str | None, column: str | None, overwrite = False)
```

[المصدر](https://github.com/huggingface/transformers/blob/main/src/transformers/pipelines/base.py#L475)

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

format (`str`) : صيغة خط الأنابيب المطلوب. القيم المقبولة هي `"json"` أو `"csv"` أو `"pipe"`.

output_path (`str`، *اختياري*) : مكان حفظ البيانات الصادرة.

input_path (`str`، *اختياري*) : المكان الذي يتم فيه البحث عن بيانات الإدخال.

column (`str`، *اختياري*) : العمود الذي يجب قراءته.

overwrite (`bool`، *اختياري*، القيمة الافتراضية `False`) : ما إذا كان سيتم تجاوز `output_path` أم لا.

**يعيد:** [PipelineDataFormat](/docs/transformers/main/ar/internal/pipelines_utils#transformers.PipelineDataFormat)

الصيغة الصحيحة للبيانات.

ينشئ مثيلاً من الفئة الفرعية الصحيحة لـ [PipelineDataFormat](/docs/transformers/main/ar/internal/pipelines_utils#transformers.PipelineDataFormat) اعتماداً على `format`.

#### حفظ[[transformers.PipelineDataFormat.save]]

```python
save(data: dict | list[dict])
```

[المصدر](https://github.com/huggingface/transformers/blob/main/src/transformers/pipelines/base.py#L447)

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

data (`dict` أو قائمة من `dict`) : البيانات التي يجب تخزينها.

احفظ كائن البيانات المُقدَّم مع التمثيل الخاص بـ [PipelineDataFormat](/docs/transformers/main/ar/internal/pipelines_utils#transformers.PipelineDataFormat) الحالي.

#### save_binary[[transformers.PipelineDataFormat.save_binary]]

```python
save_binary(data: dict | list[dict])
```

[المصدر](https://github.com/huggingface/transformers/blob/main/src/transformers/pipelines/base.py#L457)

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

data (`dict` أو قائمة من `dict`) : البيانات التي سيتم تخزينها.

**يعيد:** `str`

المسار الذي تم حفظ البيانات فيه.

احفظ كائن البيانات المُقدَّم كبيانات ثنائية بتنسيق pickle على القرص.

#### transformers.CsvPipelineDataFormat[[transformers.CsvPipelineDataFormat]]

```python
transformers.CsvPipelineDataFormat(output_path: str | None, input_path: str | None, column: str | None, overwrite = False)
```

[المصدر](https://github.com/huggingface/transformers/blob/main/src/transformers/pipelines/base.py#L511)

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

output_path (`str`) : مكان حفظ البيانات الصادرة.

input_path (`str`) : المكان الذي يجب البحث فيه عن البيانات المدخلة.

column (`str`) : العمود الذي يجب قراءته.

overwrite (`bool`، *اختياري*، القيمة الافتراضية `False`) : ما إذا كان سيتم تجاوز `output_path` أم لا.

دعم خطوط الأنابيب باستخدام صيغة بيانات CSV.

#### حفظ[[transformers.CsvPipelineDataFormat.save]]

```python
save(data: list[dict])
```

[المصدر](https://github.com/huggingface/transformers/blob/main/src/transformers/pipelines/base.py#L541)

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

data (`list[dict]`) : البيانات التي سيتم تخزينها.

احفظ كائن البيانات المُقدَّم مع التمثيل الخاص بـ [PipelineDataFormat](/docs/transformers/main/ar/internal/pipelines_utils#transformers.PipelineDataFormat) الحالي.

#### transformers.JsonPipelineDataFormat[[transformers.JsonPipelineDataFormat]]

```python
transformers.JsonPipelineDataFormat(output_path: str | None, input_path: str | None, column: str | None, overwrite = False)
```

[المصدر](https://github.com/huggingface/transformers/blob/main/src/transformers/pipelines/base.py#L555)

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

output_path (`str`) : مكان حفظ البيانات الصادرة.

input_path (`str`) : المكان الذي يجب البحث فيه عن البيانات المدخلة.

column (`str`) : العمود الذي يجب قراءته.

overwrite (`bool`، *اختياري*، القيمة الافتراضية `False`) : ما إذا كان سيتم تجاوز `output_path` أم لا.

دعم خطوط الأنابيب باستخدام صيغة ملفات JSON.

#### حفظ[[transformers.JsonPipelineDataFormat.save]]

```python
save(data: dict)
```

[المصدر](https://github.com/huggingface/transformers/blob/main/src/transformers/pipelines/base.py#L586)

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

data (`dict`) : البيانات التي سيتم تخزينها.

احفظ كائن البيانات المُقدَّم في ملف json.

#### transformers.PipedPipelineDataFormat[[transformers.PipedPipelineDataFormat]]

```python
transformers.PipedPipelineDataFormat(output_path: str | None, input_path: str | None, column: str | None, overwrite: bool = False)
```

[المصدر](https://github.com/huggingface/transformers/blob/main/src/transformers/pipelines/base.py#L597)

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

output_path (`str`) : مكان حفظ البيانات الصادرة.

input_path (`str`) : المكان الذي يجب البحث فيه عن البيانات المدخلة.

column (`str`) : العمود الذي يجب قراءته.

overwrite (`bool`، *اختياري*، القيمة الافتراضية `False`) : ما إذا كان سيتم تجاوز `output_path` أم لا.

اقرأ البيانات من الإدخال المُوجَّه إلى عملية بايثون. وفي حالة البيانات متعددة الأعمدة، يجب فصل الأعمدة ب

إذا تم توفير الأعمدة، فسيكون المخرج قاموسًا بصيغة {column_x: value_x}

#### حفظ[[transformers.PipedPipelineDataFormat.save]]

```python
save(data: dict)
```

[المصدر](https://github.com/huggingface/transformers/blob/main/src/transformers/pipelines/base.py#L626)

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

data (`dict`) : البيانات التي سيتم تخزينها.

اطبع البيانات.

## أدوات[[transformers.pipelines.PipelineException]]

#### transformers.pipelines.PipelineException[[transformers.pipelines.PipelineException]]

```python
transformers.pipelines.PipelineException(task: str, model: str, reason: str)
```

[المصدر](https://github.com/huggingface/transformers/blob/main/src/transformers/pipelines/base.py#L371)

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

task (`str`) : مهمة خط المعالجة.

model (`str`) : النموذج المستخدم في خط المعالجة.

reason (`str`) : رسالة الخطأ التي يجب عرضها.

تُستدعى بواسطة [Pipeline](/docs/transformers/main/ar/main_classes/pipelines#transformers.Pipeline) عند معالجة __call__.