design_patterns-horizontal_versioning

What problem does it solve?

Managing horizontal versioning of persistent data structures is complex: you need to maintain multiple concrete versions, upgrade paths, and a robust serialization strategy to ensure backward compatibility.

Core Features & Use Cases

• One interface, many versions: each version is a separate struct implementing the same behavior.
• Clear upgrade paths: previous versions implement Upgrade() to the next version, enabling forward-compatibility and safe migrations.
• Type-safe serialization: use registered type strings and coders to deserialize into the correct concrete version.

Quick Start

Create a new version file (e.g., v3.go), implement Upgrade() from the previous version, register the new type string, and extend the coder map to enable serialization.