Introduction to Kindly Logger

The kindly-logger is a powerful, user-friendly logging library in Python designed to provide a comprehensive and customizable logging experience. This guide introduces the kindly-logger library and explains its many useful functionalities with code snippets and examples, helping you integrate advanced logging capabilities into your applications effortlessly.

Getting Started

To install kindly-logger, use pip:

  pip install kindly-logger

Basic Configuration

Setting up the logger is simple. Here’s how to configure a basic logger:

  
    from kindly_logger import Logger

    logger = Logger(name='my_logger')
    logger.info('This is an info message')
    logger.error('This is an error message')
  

Advanced Configuration

kindly-logger supports advanced configurations such as custom formats and log levels. Here’s an example:

  
    logger = Logger(name='advanced_logger', level='DEBUG', format='%(asctime)s - %(name)s - %(levelname)s - %(message)s')
    logger.debug('This is a debug message')
  

Using Handlers

Add handlers to direct logs to different destinations, such as a file. Here’s how:

  
    from kindly_logger import Logger, FileHandler

    file_handler = FileHandler('app.log')
    logger = Logger(name='file_logger', handlers=[file_handler])
    logger.info('This message is logged to a file')
  

Filters

Use filters to manage which log records are processed. Here’s an example:

  
    from kindly_logger import Logger, Filter

    class CustomFilter(Filter):
        def filter(self, record):
            return 'custom' in record.msg

    logger = Logger(name='filtered_logger', filters=[CustomFilter()])
    logger.info('This will not be logged')
    logger.info('This contains custom and will be logged')
  

Application Example

Here’s a complete application example using various features of kindly-logger:

  
    from kindly_logger import Logger, FileHandler, Filter

    class CustomFilter(Filter):
        def filter(self, record):
            return 'custom' in record.msg

    logger = Logger(
        name='app_logger',
        level='DEBUG',
        format='%(asctime)s - %(name)s - %(levelname)s - %(message)s',
        handlers=[FileHandler('app.log')],
        filters=[CustomFilter()]
    )

    logger.debug('This is a debug message')
    logger.info('This is a custom info message')
    logger.error('This error message will also be logged')
  

By using the comprehensive features of kindly-logger, you can achieve a robust logging system in Python. This library simplifies the process of tracking and debugging your applications, ensuring you have detailed and clear log records.

Hash: 9008a913ea62deaa77f55b4a27d405238b873a5a10242c573155fccaf8102fa5