Descargar logly - Descargar el código fuente logly

¿Cansado de escribir código de registro personalizado para sus aplicaciones de Python?

Logly es una utilidad de registro de registro listo para ir que proporciona una manera fácil de registrar mensajes con diferentes niveles, colores y muchas opciones personalizadas. Está diseñado para ser flexible, lo que le permite personalizar los mensajes de registro en función de las necesidades de su aplicación. Logly admite registro tanto para la consola como en un archivo, y viene con niveles de registro codificados por colores incorporados para una mejor visibilidad.

Si te gusta este proyecto, ¿asegúrate de protagonizar? En el repositorio y si desea contribuir, asegúrese de desembolsar este repositorio❤.

Tabla de contenido

Introducción
Instalación
Características
Uso
- Empezando
- Explicación
Establecer ruta predeterminada
Opciones de color
- Opciones de color predeterminadas
- Opciones de color personalizadas
Consejos y trucos
Que contribuye
Código de conducta
Licencia
Apoyar el proyecto
Codificación feliz

Características

Registro fácil de usar para aplicaciones de Python.
Niveles de registro y formato personalizables.
Colores de registro personalizables.
Registre a archivo y/o consola.
Iniciar sesión para archivar con rotación automática de archivos.
Iniciar sesión para archivar con administración automática del tamaño del archivo.
Iniciar sesión para archivar con eliminación automática de archivos.
Iniciar sesión para archivar con eliminación automática y reescritura del archivo cuando llegue a max_file_size.
Open Source: Logly es un proyecto de código abierto, y damos la bienvenida a las contribuciones de la comunidad.
Apoyo a la comunidad: únase a una comunidad de desarrolladores que usan LOGLY para sus necesidades de registro.
¡Muchas más características!

Empezando

Instalación

pip install logly

Uso

 # 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 )

Explicación:

Importe la clase Logly desde el módulo logly .
Cree una instancia de Logly .
Comience a registrarse usando el método start_logging() .
Registre mensajes con varios niveles (información, advertencia, error, depuración, crítico, fatal, rastreo) y colores.
Deje de registrar el método stop_logging() .
Registre mensajes adicionales después de dejar de registrarse.
Comience a registrar nuevamente.
Registre mensajes con configuración predeterminada, ruta de archivo personalizado y tamaño máximo del archivo.
Acceda a las constantes de color directamente.
Muestra mensajes registrados.
Habilitar/deshabilitar el soporte de marca de tiempo
Habilitar/deshabilitar el color para soporte de registro

Para obtener más información, consulte el repositorio

Establecer la ruta predeterminada

Si encuentra un error relacionado con la ruta del archivo predeterminado, puede usar el siguiente fragmento de código para establecer la ruta predeterminada:

 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 )

Esto establecerá la ruta de archivo predeterminada y puede personalizarla de acuerdo con sus requisitos.

Si desea establecer la ruta predeterminada para el archivo de registro, puede usar el siguiente fragmento de código

 from logly import Logly
logly = Logly ()
logly . set_default_file_path ( "log.txt" )

Si enfrentó un error como FileNotFoundError: [Errno 2] No such file or directory: 'log.txt' puede usar el siguiente fragmento de código para establecer la ruta predeterminada

 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 )

Para obtener más información, consulte el repositorio.

Opciones de color:

Opciones de color predeterminadas:

Nivel	Código de colores
Información	Cian
ADVERTENCIA	AMARILLO
ERROR	ROJO
DEPURAR	AZUL
CRÍTICO	LACRE
RASTRO	AZUL
POR DEFECTO	BLANCO

Opciones de color personalizadas:

Puede usar cualquiera de los siguientes códigos de color para colorear personalizados:

NOMBRE	Código de colores
Cian	Cian
AMARILLO	AMARILLO
ROJO	ROJO
AZUL	AZUL
LACRE	CRÍTICO
BLANCO	BLANCO

Por ejemplo, puede usar color=logly.COLOR.RED para el color rojo.

Consejos y trucos

Si desea usar LOGLY en los archivos de su proyecto sin crear un nuevo objeto en cada archivo o clase de Python, puede crear un archivo llamado Logly.py. En este archivo, inicialice LOGLY y configure los valores predeterminados. Ahora, puede importarlo fácilmente a lo largo de su proyecto:

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 ()

Ahora puede usar LOGLY BY

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

producción

 [XXXX-XX-XX XX:XX: XX] INFo: msg: hello this is logly

Que contribuye

¡Las contribuciones son bienvenidas! Antes de contribuir, lea nuestras pautas contribuyentes para garantizar un proceso de desarrollo suave y colaborativo.