Bucket Module Documentation

Overview

The Bucket module provides a simplified, robust interface for interacting with S3-compatible object storage services such as MinIO, AWS S3, and Cellar. Built on top of the boto3 library, it abstracts away the complexity of direct S3 API calls while providing comprehensive error handling, automatic connection management, and clean logging.

Key Features

• S3-Compatible: Works with AWS S3, MinIO, Cellar, and any S3-compatible service
• Connection Management: Automatic connection initialization and health checking
• Error Handling: Comprehensive exception handling with detailed logging
• Type Safety: Strongly typed with Protocol-based type hints
• Singleton Pattern: Uses FinalClass metaclass to prevent subclassing
• Lazy Connection: Supports both auto-connect and lazy connection patterns

Architecture