Download de logly - Download de código fonte logly

Cansado de escrever código de registro personalizado para seus aplicativos Python?

O Logly é um utilitário de log pronto para ir que forneça uma maneira fácil de registrar mensagens com diferentes níveis, cores e muitas opções personalizadas. Ele foi projetado para ser flexível, permitindo que você personalize as mensagens de log com base nas necessidades do seu aplicativo. O logly suporta o log no console e no arquivo, e vem com níveis de log de cores incorporados para obter uma melhor visibilidade.

Se você gosta deste projeto, certifique -se de estrelar? no repositório e se você quiser contribuir, verifique este repositório❤.

Índice

Introdução
Instalação
Características
Uso
- Começando
- Explicação
Defina o caminho padrão
Opções de cores
- Opções de cores padrão
- Opções de cores personalizadas
Dicas e truques
Contribuindo
Código de Conduta
Licença
Apoie o projeto
Codificação feliz

Características

Registro fácil de usar para aplicativos Python.
Níveis de log e formatação personalizáveis.
Cores de log personalizáveis.
Faça logon no arquivo e/ou console.
Faça login para arquivar com rotação automática de arquivo.
Faça login para arquivar com gerenciamento automático de tamanho de arquivo.
Faça login para arquivar com exclusão automática de arquivo.
Faça login para arquivar com exclusão e reescrita automáticas do arquivo quando atingir o max_file_size.
Open Source: Logly é um projeto de código aberto e recebemos contribuições da comunidade.
Apoio à comunidade: junte -se a uma comunidade de desenvolvedores usando o logly para suas necessidades de registro.
Muitos outros recursos!

Começando

Instalação

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 )

Explicação:

Importe a classe Logly do módulo logly .
Crie uma instância de Logly .
Inicie o registro usando o método start_logging() .
Mensagens de registro com vários níveis (informações, aviso, erro, depuração, crítico, fatal, rastreamento) e cores.
Pare de registrar usando o método stop_logging() .
Registre mensagens adicionais após a interrupção do registro.
Comece a fazer o login novamente.
Mensagens de log com configurações padrão, caminho de arquivo personalizado e tamanho máximo de arquivo.
Acesse as constantes de cores diretamente.
Exibir mensagens registradas.
Ativar/desativar o suporte a data e hora
Ativar/desativar a cor para suporte ao log

Para mais informações, verifique o repositório

Defina o caminho padrão

Se você encontrar um erro relacionado ao caminho do arquivo padrão, poderá usar o seguinte snippet de código para definir o caminho padrão:

 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 )

Isso definirá o caminho do arquivo padrão e você poderá personalizá -lo de acordo com seus requisitos.

Se você deseja definir o caminho padrão para o arquivo de log, você pode usar o seguinte snippet de código

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

Se você enfrentou um erro como FileNotFoundError: [Errno 2] No such file or directory: 'log.txt' você pode usar o seguinte snippet de código para definir o caminho padrão

 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 mais informações, verifique o repositório.

Opções de cores:

Opções de cores padrão:

Nível	Código de cores
Informações	CIANO
AVISO	AMARELO
ERRO	VERMELHO
DEPURAR	AZUL
Crítico	Vermelho brilhante
Traço	AZUL
PADRÃO	BRANCO

Opções de cores personalizadas:

Você pode usar qualquer um dos seguintes códigos de cores para colorir personalizado:

NOME	Código de cores
CIANO	CIANO
AMARELO	AMARELO
VERMELHO	VERMELHO
AZUL	AZUL
Vermelho brilhante	Crítico
BRANCO	BRANCO

Por exemplo, você pode usar color=logly.COLOR.RED para a cor vermelha.

Dicas e truques

Se você deseja usar o logly nos arquivos do seu projeto sem criar um novo objeto em cada arquivo ou classe Python, poderá criar um arquivo chamado logly.py. Neste arquivo, inicialize logly e configure os padrões. Agora, você pode importar e usá -lo facilmente ao longo do seu projeto:

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

Agora você pode usar o logly por

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

saída

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

Contribuindo

As contribuições são bem -vindas! Antes de contribuir, leia nossas diretrizes contribuintes para garantir um processo de desenvolvimento suave e colaborativo.