python-storage-abstraction

What problem does it solve?

The Python Storage Protocol Pattern provides a clean, testable abstraction layer for filesystem-like operations using Python's typing.Protocol. It enables dependency injection of storage backends and avoids filesystem side effects in tests.

Core Features & Use Cases

• Testability: Use a MemoryStorage in tests to simulate file I/O without touching disk.
• Flexibility: Swap backends (filesystem, in-memory, or mock) without changing business logic.
• Architecture: Promote clean separation of concerns by programming to a protocol rather than concrete implementations.
• Use Case: Build services that persist data using a storage interface and verify behavior via unit tests with in-memory storage.

Quick Start

• Instantiate a MemoryStorage and inject it into your service to perform in-memory reads and writes, enabling fast, deterministic tests without touching the filesystem.
• Run your unit tests to validate storage-backed logic.