Diffusers documentation

التسجيل

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

and get access to the augmented documentation experience

to get started

التسجيل

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

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

import diffusers

diffusers.logging.set_verbosity_info()

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

DIFFUSERS_VERBOSITY=error ./myprogram.py

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

DIFFUSERS_NO_ADVISORY_WARNINGS=1 ./myprogram.py

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

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.FATAL50الإبلاغ عن الأخطاء الأكثر أهمية فقط
diffusers.logging.ERROR40الإبلاغ عن الأخطاء فقط
diffusers.logging.WARNING أو diffusers.logging.WARN30الإبلاغ عن الأخطاء والتحذيرات فقط (الافتراضي)
diffusers.logging.INFO20الإبلاغ عن الأخطاء والتحذيرات والمعلومات الأساسية فقط
diffusers.logging.DEBUG10تقرير جميع المعلومات

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

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

diffusers.utils.logging.set_verbosity_error

< >

( )

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

diffusers.utils.logging.set_verbosity_warning

< >

( )

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

diffusers.utils.logging.set_verbosity_info

< >

( )

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

diffusers.utils.logging.set_verbosity_debug

< >

( )

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

دوال أخرى

diffusers.utils.logging.get_verbosity

< >

( ) → int

يعيد

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

< >

( verbosity: int )

المعاملات

  • 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

< >

( name: str | None = None )

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

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

diffusers.utils.logging.enable_default_handler

< >

( )

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

diffusers.utils.logging.disable_default_handler

< >

( )

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

diffusers.utils.logging.enable_explicit_format

< >

( )

enable_explicit_formatting لتفعيل التنسيق الصريح لكل مسجّل في 🤗 Diffusers. التنسيق الصريح هو على النحو التالي:

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

diffusers.utils.logging.reset_format

< >

( )

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

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

diffusers.utils.logging.enable_progress_bar

< >

( )

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

diffusers.utils.logging.disable_progress_bar

< >

( )

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

Update on GitHub