Skip to content

error-handling

Directory actions

More options

Directory actions

More options

Latest commit

 

History

History

error-handling

README.md

Python Error Handling Best Practices

This directory contains comprehensive resources for mastering error handling in Python, from basic exception handling to advanced error recovery strategies.

📚 Overview

Error handling is crucial for building robust, maintainable Python applications. This collection covers everything from fundamental try-except blocks to sophisticated error recovery patterns used in production systems.

🎯 Learning Path

Beginner Level

Start with these fundamentals:

  • Exception basics - Understanding how exceptions work
  • Try-except patterns - Basic error handling structures
  • Common exceptions - Built-in exception types and when they occur

Intermediate Level

Build on the basics:

  • Custom exceptions - Creating meaningful error types
  • Exception chaining - Preserving error context
  • Error logging - Comprehensive logging strategies

Advanced Level

Master professional techniques:

  • Context managers - Resource cleanup and error handling
  • Defensive programming - Writing error-resistant code
  • Error recovery - Sophisticated recovery strategies

📁 Files and Topics

File Topic Difficulty Description
01-exception-basics.py Exception Fundamentals Beginner Core concepts, try-except blocks, exception hierarchy
02-try-except-patterns.py Try-Except Patterns Beginner-Intermediate Advanced patterns, multiple exceptions, else/finally
03-custom-exceptions.py Custom Exceptions Intermediate Creating custom exception classes and hierarchies
04-exception-chaining.py Exception Chaining Intermediate Preserving error context with raise from
05-logging-errors.py Error Logging Intermediate Comprehensive logging strategies and best practices
06-context-managers-cleanup.py Context Managers Advanced Resource management and cleanup with context managers
07-defensive-programming.py Defensive Programming Advanced Writing robust, error-resistant code
08-error-recovery-strategies.py Error Recovery Advanced Retry mechanisms, circuit breakers, graceful degradation

🚀 Quick Start

1. Start with the Tutorial

For a comprehensive learning experience, begin with the detailed tutorial:

# Read the complete tutorial guide
cat tutorial/README.md

2. Run the Examples

Each file contains runnable examples with detailed explanations:

# Example: Basic exception handling
python 01-exception-basics.py

# Example: Advanced error recovery
python 08-error-recovery-strategies.py

3. Practice with Real Scenarios

Each file includes practical exercises and real-world scenarios to help you apply the concepts.

🔑 Key Concepts Covered

Exception Handling Fundamentals

  • Exception hierarchy - Understanding Python's exception structure
  • Try-except-else-finally - Complete exception handling flow
  • Exception objects - Working with exception instances
  • Stack traces - Reading and preserving error information

Advanced Patterns

  • Custom exception hierarchies - Designing meaningful error types
  • Exception chaining - Preserving original error context
  • Context managers - Automatic resource cleanup
  • Error recovery strategies - Retry, circuit breaker, fallback patterns

Production Best Practices

  • Logging strategies - Structured error logging
  • Monitoring and alerting - Error tracking in production
  • Performance considerations - Efficient exception handling
  • Testing exceptions - Unit testing error scenarios

🛠️ Practical Applications

File Operations

# Robust file handling with proper cleanup
try:
    with open('data.txt', 'r') as file:
        data = file.read()
        process_data(data)
except FileNotFoundError:
    logger.error("Data file not found")
    use_default_data()
except PermissionError:
    logger.error("Permission denied accessing file")
    request_elevated_permissions()

Network Operations

# Network requests with retry logic
@retry(max_attempts=3, backoff_factor=2)
def fetch_data(url):
    try:
        response = requests.get(url, timeout=10)
        response.raise_for_status()
        return response.json()
    except requests.RequestException as e:
        logger.warning(f"Request failed: {e}")
        raise

Database Operations

# Database operations with transaction handling
class DatabaseManager:
    def safe_transaction(self, operations):
        try:
            self.begin_transaction()
            for operation in operations:
                operation()
            self.commit()
        except DatabaseError:
            self.rollback()
            raise
        finally:
            self.close_connection()

📋 Best Practices Summary

✅ Do's

  • Be specific - Catch specific exception types, not generic Exception
  • Preserve context - Use exception chaining with raise from
  • Log appropriately - Include relevant context in error messages
  • Clean up resources - Use context managers or try-finally blocks
  • Fail fast - Validate inputs early and raise meaningful errors
  • Document exceptions - Specify what exceptions your functions can raise

❌ Don'ts

  • Don't ignore exceptions - Avoid bare except: clauses
  • Don't catch and continue silently - Always handle or re-raise
  • Don't use exceptions for control flow - Exceptions should be exceptional
  • Don't expose internal details - Sanitize error messages for users
  • Don't forget cleanup - Always release resources properly

🔍 Common Patterns

The EAFP Principle

"Easier to Ask for Forgiveness than Permission" - Python's preferred approach:

# EAFP (Pythonic)
try:
    value = my_dict[key]
except KeyError:
    value = default_value

# LBYL (Less Pythonic)
if key in my_dict:
    value = my_dict[key]
else:
    value = default_value

Error Boundaries

Create clear error boundaries in your application:

class APIErrorBoundary:
    def __call__(self, func):
        def wrapper(*args, **kwargs):
            try:
                return func(*args, **kwargs)
            except ValidationError as e:
                return {"error": "Invalid input", "details": str(e)}
            except DatabaseError as e:
                logger.error(f"Database error: {e}")
                return {"error": "Internal server error"}
            except Exception as e:
                logger.critical(f"Unexpected error: {e}")
                return {"error": "Service unavailable"}
        return wrapper

🧪 Testing Your Knowledge

After studying the materials, test your understanding:

  1. Basic Level: Can you handle file operations safely?
  2. Intermediate Level: Can you create custom exception hierarchies?
  3. Advanced Level: Can you implement retry mechanisms and circuit breakers?

📖 Additional Resources

Related Topics

  • Logging - ../logging/ (if available)
  • Testing - ../../testing/ for testing exception scenarios
  • Async Programming - ../async-programming/ for async exception handling

External Resources

🤝 Contributing

When adding new error handling examples:

  1. Follow the existing file naming convention
  2. Include comprehensive docstrings and comments
  3. Provide both basic and advanced examples
  4. Add practical, real-world scenarios
  5. Update this README with new content

Next Steps: Start with 01-exception-basics.py or dive into the comprehensive tutorial/README.md for a complete learning experience!