All notable changes to this project will be documented in this file.
The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.
append_filemethod to all storage backends for efficient file appending- LocalStorage: Uses native filesystem append operations
- S3Storage: Implements intelligent strategy selection between single-file and multi-part patterns
- GCSStorage: Similar to S3 with support for both single-file and multi-part strategies
- Multi-part file pattern for cloud storage to efficiently handle large file appends
- Automatic strategy selection based on file size (default threshold: 100MB)
- Transparent reading of multi-part files through existing
read_filemethod - Manifest-based tracking of file parts for cloud storage
AppendResultnamed tuple to provide detailed information about append operationsManifestManagerutility class for handling multi-part file manifests- Comprehensive test coverage for all append operations (45 tests total)
- Enhanced
read_filemethod in S3Storage and GCSStorage to transparently handle multi-part files - Updated type hints to include new append-related types
- Minor bug fixes and improvements
storage_typeparameter toget_storagefor explicit backend selection
- py.typed file for full type checking support
- Lazy loading of storage providers to prevent ModuleNotFoundError
- Unified storage interface for Local, S3, and GCS
- Basic file operations: save, read, upload, exists, get_url
- Factory pattern for automatic backend selection
- Environment variable-based configuration