python-infrastructure-exceptions

Infrastructure layer exception classes for Python applications.

Purpose: Low-level infrastructure errors (database, network, external services).

Separation:

• python-infrastructure-exceptions = Infrastructure layer (DB, network, cache, queue)
• python-app-exceptions = Business/application layer (validation, business rules)

Installation

pip install python-infrastructure-exceptions

Usage

from python_infrastructure_exceptions import (
    InfrastructureException,
    DatabaseError,
    ExternalServiceError,
    ConfigurationError,
    CacheError,
    MessageQueueError
)

# Database errors
raise DatabaseError("Connection pool exhausted", details="Max connections: 20")

# External service errors
raise ExternalServiceError("Stripe API timeout", service_name="stripe")

# Configuration errors
raise ConfigurationError("Missing DATABASE_URL environment variable")

# Cache errors
raise CacheError("Redis connection failed", details="Connection refused")

# Message queue errors
raise MessageQueueError("Kafka broker unavailable", details="broker.example.com:9092")

Exception Hierarchy

InfrastructureException (base)
├── DatabaseError              # Database connection, query failures
├── ExternalServiceError       # Third-party API failures
├── ConfigurationError         # Missing/invalid configuration
├── CacheError                 # Redis, Memcached failures
└── MessageQueueError          # Kafka, RabbitMQ failures

When to Use

Comparison with python-app-exceptions

Features

• ✅ Infrastructure-specific error types
• ✅ Detailed error context (service name, connection details)
• ✅ Framework-agnostic
• ✅ Zero dependencies
• ✅ Type-safe error handling

License

MIT