logly
v0.0.6
تعبت من كتابة رمز التسجيل المخصص لتطبيقات Python الخاصة بك؟
Logly هي أداة تسجيل جاهزة للذهاب إلى طريقة سهلة لتسهيل تسجيل الرسائل بمستويات وألوان مختلفة والعديد من الخيارات المخصصة. إنه مصمم ليكون مرنًا ، مما يتيح لك تخصيص رسائل السجل بناءً على احتياجات التطبيق الخاصة بك. يدعم Logly التسجيل إلى كل من وحدة التحكم والملف ، ويأتي مع مستويات السجل المدمجة بالألوان لتحسين الرؤية.
إذا كنت تحب هذا المشروع ، فتأكد من نجمة؟ إنه في المستودع وإذا كنت تريد المساهمة ، فتأكد من توتر هذا المستودع.
pip install logly # Import Logly
from logly import Logly
# Create a Logly instance
logly = Logly ()
# logly = Logly(show_time=False) # Include timestamps in log messages default is true, and you can set it to false will not show the time in all log messages
# Start logging will store the log in text file
logly . start_logging () #make sure to include this or else the log will only display without storing it in file
logly . info ( "hello this is log" )
logly . info ( "hello this is log" , color = logly . COLOR . RED ) # with custom color
# Log messages with different levels and colors
logly . info ( "Key1" , "Value1" , color = logly . COLOR . CYAN )
logly . warn ( "Key2" , "Value2" , color = logly . COLOR . YELLOW )
logly . error ( "Key3" , "Value3" , color = logly . COLOR . RED )
logly . debug ( "Key4" , "Value4" , color = logly . COLOR . BLUE )
logly . critical ( "Key5" , "Value5" , color = logly . COLOR . CRITICAL )
logly . fatal ( "Key6" , "Value6" , color = logly . COLOR . CRITICAL )
logly . trace ( "Key7" , "Value7" , color = logly . COLOR . BLUE )
logly . log ( "Key8" , "Value8" , color = logly . COLOR . WHITE )
# Stop logging (messages will be displayed but not logged in file after this point)
logly . stop_logging ()
# Log more messages after stopping logging (messages will be displayed but not logged in file after this point)
logly . info ( "AnotherKey1" , "AnotherValue1" , color = logly . COLOR . CYAN )
logly . warn ( "AnotherKey2" , "AnotherValue2" , color = logly . COLOR . YELLOW )
logly . error ( "AnotherKey3" , "AnotherValue3" , color = logly . COLOR . RED )
logly . info ( "hello this is log" , color = logly . COLOR . RED , show_time = False ) # with custom color and without time
# Start logging again
logly . start_logging ()
# Set the default file path and max file size
logly . set_default_file_path ( "log.txt" ) # Set the default file path is "log.txt" if you want to set the file path where you want to save the log file.
logly . set_default_max_file_size ( 50 ) # set default max file size is 50 MB
# Log messages with default settings (using default file path and max file size)
logly . info ( "DefaultKey1" , "DefaultValue1" )
logly . warn ( "DefaultKey2" , "DefaultValue2" )
logly . error ( "DefaultKey3" , "DefaultValue3" , log_to_file = False )
#The DEFAULT FILE SIZE IS 100 MB in the txt file
# Log messages with custom file path and max file size(optional)
logly . info ( "CustomKey1" , "CustomValue1" , file_path = "path/c.txt" , max_file_size = 25 ) # max_file_size is in MB and create a new file when the file size reaches max_file_size
logly . warn ( "CustomKey2" , "CustomValue2" , file_path = "path/c.txt" , max_file_size = 25 , auto = True ) # auto=True will automatically delete the file data when it reaches max_file_size
# Access color constants directly
logly . info ( "Accessing color directly" , "DirectColorValue" , color = logly . COLOR . RED )
# Disable color
logly . color_enabled = False
logly . info ( "ColorDisabledKey" , "ColorDisabledValue" , color = logly . COLOR . RED )
logly . info ( "ColorDisabledKey1" , "ColorDisabledValue1" , color = logly . COLOR . RED , color_enabled = True ) # This will enable the color for this one log message
logly . color_enabled = True
# this will enable the color again
logly . info ( "ColorDisabledKey1" , "ColorDisabledValue1" , color = logly . COLOR . RED , color_enabled = False ) # this will disable the color for this one log message
# Display logged messages (this will display all the messages logged so far)
print ( "Logged Messages:" )
for message in logly . logged_messages :
print ( message )Logly من وحدة logly .Logly .start_logging() .stop_logging() .لمزيد من المعلومات ، تحقق من المستودع
إذا واجهت خطأً يتعلق بمسار الملف الافتراضي ، فيمكنك استخدام مقتطف الرمز التالي لتعيين المسار الافتراضي:
import os
from logly import Logly
logly = Logly ()
logly . start_logging ()
# Set the default file path and maximum file size
logly . set_default_max_file_size ( 50 )
logger = os . path . join ( os . path . dirname ( os . path . abspath ( __file__ )), "log.txt" )
logly . set_default_file_path ( logger )سيؤدي ذلك إلى تعيين مسار الملف الافتراضي ، ويمكنك تخصيصه وفقًا لمتطلباتك.
إذا كنت ترغب في تعيين المسار الافتراضي لملف السجل ، فيمكنك استخدام مقتطف الرمز التالي
from logly import Logly
logly = Logly ()
logly . set_default_file_path ( "log.txt" ) إذا واجهت خطأً مثل FileNotFoundError: [Errno 2] No such file or directory: 'log.txt' يمكنك استخدام مقتطف الرمز التالي لتعيين المسار الافتراضي
import os
from logly import Logly
logly = Logly () # initialize the logly
logly . start_logging () # make sure to include this or else the log will only display without storing it
logly . set_default_max_file_size ( 50 ) # optional
logger = os . path . join ( os . path . dirname ( os . path . abspath ( __file__ )), "log.txt" ) # This will ensure the path location to create the log.txt on current directory
logly . set_default_file_path ( logger )لمزيد من المعلومات ، تحقق من المستودع.
| مستوى | رمز اللون |
|---|---|
| معلومات | سماوي |
| تحذير | أصفر |
| خطأ | أحمر |
| تصحيح | أزرق |
| شديد الأهمية | أحمر مشرق |
| يتعقب | أزرق |
| تقصير | أبيض |
يمكنك استخدام أي من رموز الألوان التالية للتلوين المخصص:
| اسم | رمز اللون |
|---|---|
| سماوي | سماوي |
| أصفر | أصفر |
| أحمر | أحمر |
| أزرق | أزرق |
| أحمر مشرق | شديد الأهمية |
| أبيض | أبيض |
على سبيل المثال ، يمكنك استخدام color=logly.COLOR.RED للون الأحمر.
إذا كنت ترغب في استخدام Logly في ملفات المشروع الخاصة بك دون إنشاء كائن جديد في كل ملف أو فئة Python ، فيمكنك إنشاء ملف اسمه logly.py. في هذا الملف ، قم بتهيئة تسجيل الدخول وتكوين الافتراضات. الآن ، يمكنك بسهولة استيرادها واستخدامها خلال مشروعك:
logly.py
# logly.py in your root or custom path
# Import Logly
from logly import Logly
import os
logly = Logly ()
logly . start_logging ()
# Set the default file path and maximum file size
logly . set_default_max_file_size ( 50 )
logger = os . path . join ( os . path . dirname ( os . path . abspath ( __file__ )), "log.txt" ) # This will ensure the path location to create the log.txt
logly . set_default_file_path ( logger )
# Start logging again
logly . start_logging ()يمكنك الآن استخدام logly بواسطة
main.py
from logly import logly # make sure to import it some IDE may automatically import it on top
logly . info ( "msg" , "hello this is logly" , color = logly . COLOR . RED ) # with custom color of red [XXXX-XX-XX XX:XX: XX] INFo: msg: hello this is logly
المساهمات مرحب بها! قبل المساهمة ، يرجى قراءة إرشاداتنا المساهمة لضمان عملية تطوير سلسة وتعاونية.
يرجى مراجعة مدونة قواعد السلوك الخاصة بنا لفهم معايير السلوك التي نتوقعها من المساهمين ومستخدمي هذا المشروع.
هذا المشروع مرخص بموجب ترخيص معهد ماساتشوستس للتكنولوجيا. انظر الترخيص لمزيد من التفاصيل.
دعم المشروع من خلال أن يصبح راعيا على جيثب
