prelogging 0.4.3

prelogging is a pure Python package that provides a simple, consistent, powerful API for configuring logging. The package includes several “batteries”:

• consistent methods to add handlers both mundane and exotic
• multiprocessing-safe handlers which output to the console, to files and rotating files, and to the system log
• formatter presets — a fund of useful shorthands for formatters, which you can extend and modify

Chapters

• Introduction and Setup
  • Requirements
  • Installation
  • Running tests and examples
• Overview of Logging
  • Using logging
  • logging classes that can be configured
  • Loggers are identified by name
  • How a message is logged
  • logging defaults
  • logging documentation links
• Configuration — with logging, and with prelogging
  • Logging configuration requirements — example
  • Meeting the configuration requirements with logging
  • Configuration with prelogging
• LCDictBasic Organization and Basic Usage
  • Configuration with LCDictBasic
  • Methods and properties
  • prelogging warnings and consistency checking
• LCDict Features and Usage
  • Using formatter presets
  • Handler classes encapsulated by LCDict
  • Automatically attaching handlers to the root logger
  • Easy multiprocessing-safe logging
  • Simplified creation and use of filters
• Formatter Presets
  • The update_formatter_presets_from_file function
  • The update_formatter_presets function
• Configuring Loggers
  • Using non-root loggers without configuring them
  • Configuring and using non-root loggers
  • Best practices for propagation and handler placement
• Further Topics and Recipes
  • Using LCDictBuilderABC
  • Multiprocessing — two approaches
  • Using prelogging in libraries: using a null handler
  • Using prelogging with Django
  • Providing extra data to a filter
  • Adding custom fields and data to messages
  • Adding SMTPHandlers with add_email_handler
• Guide to Examples
  • Running the examples
  • Programs in the examples/ directory
• Class Reference
  • LCDictBasic
  • LCDict
  • Locking Handlers
  • LCDictBuilderABC
  • Class diagram
• Index