Hugging Face's logo

Transformers documentation

التسجيل

You are viewing main version, which requires installation from source. If you'd like regular pip install, checkout the latest stable version (v5.22.1).
Hugging Face's logo
Join the Hugging Face community

and get access to the augmented documentation experience

to get started

التسجيل

🤗 يحتوي Transformers على نظام تسجيل مركزي، مما يتيح لك ضبط مستوى تفصيل مكتبة Transformers بسهولة.

حاليًا، مستوى التفصيل الافتراضي للمكتبة هو WARNING.

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

import transformers

transformers.logging.set_verbosity_info()

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

TRANSFORMERS_VERBOSITY=error ./myprogram.py

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

TRANSFORMERS_NO_ADVISORY_WARNINGS=1 ./myprogram.py

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

from transformers.utils import logging

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

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

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

بشكل افتراضي، ستظهر أشرطة تقدم tqdm أثناء تنزيل النموذج. يمكن استخدام logging.disable_progress_bar() و logging.enable_progress_bar() لكبح هذا السلوك أو إلغاء كبحه.

التسجيل مقابل التحذيرات

يوجد في Python نظامان للتسجيل يُستخدمان غالبًا معًا: logging، الذي تم شرحه أعلاه، وwarnings، والذي يتيح تصنيف التحذيرات في فئات محددة، مثل FutureWarning لميزة أو مسار تم إيقافه بالفعل، وDeprecationWarning للإشارة إلى إيقاف قادم.

نستخدم كلاهما في مكتبة transformers. نستفيد من طريقة captureWarnings في logging ونُكيّفها للسماح بإدارة رسائل التحذير هذه من خلال مُعيّنات مستوى التفصيل المذكورة أعلاه.

ماذا يعني ذلك لمطوّري المكتبة؟ يجب علينا احترام القواعد الإرشادية التالية:

  • يجب تفضيل warnings لمطوّري المكتبة والمكتبات المعتمدة على transformers
  • يجب استخدام logging للمستخدمين النهائيين للمكتبة الذين يستخدمونها في مشاريعهم اليومية

انظر إلى مرجع طريقة captureWarnings أدناه.

transformers.utils.logging.captureWarnings

< >

( capture )

يستدعي طريقة captureWarnings من مكتبة التسجيل لتفعيل إدارة التحذيرات التي تصدرها مكتبة warnings.

Read more about this method here: https://docs.python.org/3/library/logging.html#integration-with-the-warnings-module

ستُسجَّل جميع التحذيرات عبر مسجّل py.warnings.

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

المُعيّنات الأساسية

transformers.utils.logging.set_verbosity_error

< >

( )

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

transformers.utils.logging.set_verbosity_warning

< >

( )

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

transformers.utils.logging.set_verbosity_info

< >

( )

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

transformers.utils.logging.set_verbosity_debug

< >

( )

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

دوال أخرى

transformers.utils.logging.get_verbosity

< >

( ) → int

يعيد

int

مستوى التسجيل.

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

تتوفر في 🤗 Transformers مستويات تسجيل التالية:

  • 50: transformers.logging.CRITICAL أو transformers.logging.FATAL
  • 40: transformers.logging.ERROR
  • 30: transformers.logging.WARNING أو transformers.logging.WARN
  • 20: transformers.logging.INFO
  • 10: transformers.logging.DEBUG

transformers.utils.logging.set_verbosity

< >

( verbosity: int )

المعاملات

  • verbosity (int) — مستوى التسجيل، مثل أحد المستويات التالية:
    • transformers.logging.CRITICAL أو transformers.logging.FATAL
    • transformers.logging.ERROR
    • transformers.logging.WARNING أو transformers.logging.WARN
    • transformers.logging.INFO
    • transformers.logging.DEBUG

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

transformers.utils.logging.get_logger

< >

( name: str | None = None )

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

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

transformers.utils.logging.enable_default_handler

< >

( )

فعّل المعالج الافتراضي لسجّال الجذر الخاص بـ HuggingFace Transformers.

transformers.utils.logging.disable_default_handler

< >

( )

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

transformers.utils.logging.enable_explicit_format

< >

( )

تفعيل التنسيق الصريح لكل مسجّل في مكتبة HuggingFace Transformers. التنسيق الصريح هو على النحو التالي:

    [LEVELNAME|FILENAME|LINE NUMBER] TIME >> MESSAGE
All handlers currently bound to the root logger are affected by this method.

transformers.utils.logging.reset_format

< >

( )

يعيد تعيين تنسيق مسجلات HuggingFace Transformers.

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

transformers.utils.logging.enable_progress_bar

< >

( )

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

transformers.utils.logging.disable_progress_bar

< >

( )

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

Update on GitHub

←منسّق البيانات النماذج→