Merge pull request #95 from braboj/codex/add-headings-to-logging-examples

Add heading separators for logging examples

Author: braboj

examples/13_logging/logging_advanced_config.py

@@ -1,4 +1,6 @@
-# Example: Basic and Advanced Logging Configuration
+# Advanced Logging Configuration
+# --------------------------------------------------------------------------------
+# Demonstrates custom handlers, a formatter, and propagation control.
 
 import logging
 

examples/13_logging/logging_basic_config.py

@@ -1,4 +1,6 @@
-# Example: Basic and Advanced Logging Configuration
+# Basic Logging Configuration
+# --------------------------------------------------------------------------------
+# Uses basicConfig for the root logger and a named child logger.
 
 import logging
 

examples/13_logging/logging_config_dict.py

@@ -1,4 +1,6 @@
-# Example: Logging Configuration with a Dictionary
+# Logging Configuration with a Dictionary
+# --------------------------------------------------------------------------------
+# Uses a dict to define formatters, handlers and loggers.
 
 import logging.config
 

examples/13_logging/logging_config_file.py

@@ -1,4 +1,6 @@
-# Example: Configure the logging module with a configuration file
+# Configuring Logging from a File
+# --------------------------------------------------------------------------------
+# Loads logger settings from an external configuration file.
 
 import logging.config
 

examples/13_logging/logging_exceptions.py

@@ -1,3 +1,7 @@
+# Logging Exceptions
+# --------------------------------------------------------------------------------
+# Captures an exception and logs the full stack trace.
+
 import logging
 
 a = 5

examples/13_logging/logging_formatter.py

@@ -1,4 +1,6 @@
-# Example: Basic and Advanced Logging Configuration
+# Custom Logging Formatter
+# --------------------------------------------------------------------------------
+# Configures a formatter for a named logger.
 
 import logging
 

examples/13_logging/logging_handlers.py

@@ -1,3 +1,7 @@
+# Multiple Logging Handlers
+# --------------------------------------------------------------------------------
+# Sets up stream, file and timed rotating handlers.
+
 import logging.handlers
 import time
 

examples/13_logging/logging_hierarchy.py

@@ -1,4 +1,6 @@
-# Example: Logging Objects with hierarchy
+# Logger Hierarchy
+# --------------------------------------------------------------------------------
+# Shows parent, child and grandchild loggers working together.
 
 import logging
 

examples/13_logging/logging_levels.py

@@ -1,4 +1,6 @@
-# Example: Logging Levels
+# Logging Levels
+# --------------------------------------------------------------------------------
+# Demonstrates how to emit messages for each severity level.
 
 import logging
 
@@ -10,4 +12,4 @@
 logging.info('Hello world!')
 logging.warning('Hello world!')
 logging.error('Hello world!')
-logging.critical('Hello world!')
+logging.critical('Hello world!')