Introduction to Hybrid Logger

The hybrid-logger is a comprehensive logging solution designed to offer flexibility and extensibility for various use cases. It supports multiple logging backends and provides a rich API set for developers. This guide will give you an overview of the hybrid-logger along with several examples of its powerful APIs.

Setting Up Hybrid Logger

To get started, you need to install hybrid-logger:

  pip install hybrid-logger

Basic Configuration

A basic configuration can be achieved with these simple steps:

  
    from hybrid_logger import HybridLogger

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

Advanced Configuration

Hybrid Logger allows advanced configurations for more complex logging needs:

  
    from hybrid_logger import HybridLogger, FileHandler, ConsoleHandler

    file_handler = FileHandler(filename='app.log')
    console_handler = ConsoleHandler()

    logger = HybridLogger(name='advanced_logger', handlers=[file_handler, console_handler])
    logger.error('This is an error message')
  

Filtering Logs

Filtering logs based on severity or custom filters is straightforward with hybrid-logger:

  
    from hybrid_logger import HybridLogger

    logger = HybridLogger(name='filtered_logger')
    logger.setLevel('ERROR')
    logger.debug('This debug message will not be shown')  # Not shown
    logger.error('This error message will be shown')
  

Custom Handlers

You can create custom handlers to extend the functionality:

  
    from hybrid_logger import Handler

    class CustomHandler(Handler):
        def emit(self, record):
            print(f'Custom log: {record.msg}')

    logger = HybridLogger(name='custom_handler_logger', handlers=[CustomHandler()])
    logger.info('This is a custom handler message')
  

Using Contextual Information

Add contextual information to your logs:

  
    from hybrid_logger import HybridLogger

    logger = HybridLogger(name='context_logger')
    logger = logger.bind(user='john.doe', action='update')
    logger.info('User action logged with context')
  

Complete Application Example

Below is a complete application example demonstrating some of the features discussed:

  
    from hybrid_logger import HybridLogger, FileHandler, ConsoleHandler

    def main():
        file_handler = FileHandler(filename='application.log')
        console_handler = ConsoleHandler()

        logger = HybridLogger(name='app_logger', handlers=[file_handler, console_handler])
        logger.setLevel('INFO')

        logger.info('Application started')
        try:
            # Simulate some actions
            logger = logger.bind(user='john.doe', action='initiate')
            logger.info('User initiated an action')

            if True:  # Simulate an error condition
                raise ValueError('A simulated error occurred')

        except ValueError as e:
            logger.error(f'An error occurred: {e}')

        logger.info('Application finished')

    if __name__ == '__main__':
        main()
  

The hybrid-logger provides all the necessary tools to set up a robust and versatile logging system for your applications.

Hash: 07e87e2ae60f07d4df6fbcc55a367a3ad32146ddaeae456029a9be4bd5ff715e