Datasets documentation

أدوات

Hugging Face's logo
Join the Hugging Face community

and get access to the augmented documentation experience

to get started

أدوات

إعداد التسجيل

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

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

import datasets
datasets.logging.set_verbosity_info()

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

DATASETS_VERBOSITY=error ./myprogram.py

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

بترتيب من الأقل إلى الأكثر تفصيلاً (مع قيم 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

< >

( )

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

تتميز مكتبة 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

< >

( verbosity: int )

المعاملات

  • verbosity — مستوى التسجيل، مثل datasets.logging.DEBUG وdatasets.logging.INFO.

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

datasets.utils.logging.set_verbosity_info

< >

( )

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

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

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

datasets.utils.logging.set_verbosity_warning

< >

( )

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

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

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

datasets.utils.logging.set_verbosity_debug

< >

( )

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

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

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

datasets.utils.logging.set_verbosity_error

< >

( )

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

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

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

datasets.utils.logging.disable_propagation

< >

( )

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

datasets.utils.logging.enable_propagation

< >

( )

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

تهيئة أشرطة التقدم

بشكل افتراضي، ستظهر أشرطة تقدم tqdm أثناء تنزيل مجموعة البيانات ومعالجتها مسبقاً. يمكنك تعطيلها على مستوى النظام عن طريق تعيين متغير البيئة HF_DATASETS_DISABLE_PROGRESS_BARS. كما يمكنك تفعيلها/تعطيلها باستخدام enable_progress_bars() و disable_progress_bars(). إذا تم تعيين متغير البيئة، فإن له الأولوية على الدوال المساعدة.

datasets.enable_progress_bars

< >

( )

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

استخدم disable_progress_bars() لتعطيلها.

datasets.disable_progress_bars

< >

( )

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

استخدم enable_progress_bars() لإعادة تفعيلها.

datasets.are_progress_bars_disabled

< >

( )

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

يمكن تمكين أشرطة التقدم المستخدمة في datasets أو تعطيلها على مستوى النظام باستخدام enable_progress_bars() و disable_progress_bars() أو عن طريق تعيين HF_DATASETS_DISABLE_PROGRESS_BARS كمتغير بيئة.

Update on GitHub