patrickmn/go-cache
Go Cache
go-cache is a thread-safe, in-memory cache library for Go that stores arbitrary objects with per-item expiration timestamps. It provides a concurrent key-value store where multiple goroutines can safely read and write shared cached data without external synchronization, using a mutex-guarded map for access control.
The library distinguishes itself through its expiration management and optional disk persistence. Each cached item carries its own time-to-live, and a background goroutine periodically purges expired entries. The cache can serialize its entire contents to disk using Go's gob encoding format, allowing cached data to survive application restarts and be reloaded on startup.
The library supports storing any Go object with configurable expiration durations, from temporary entries to items that persist indefinitely. Its file serialization uses gob encoding for type-safe cross-version compatibility, making it suitable for single-machine applications that need a lightweight alternative to external caching systems.
Features
- Go In-Memory Caches - Provides an in-memory key-value store for Go applications with configurable expiration and concurrent access.
- Concurrent Caches - Shares a cache safely across multiple goroutines without manual locking or race conditions.
- Lazy Expiration - Checks expiration timestamps during cache access and periodic sweeps to remove stale entries.
- In-Memory Caches - Stores frequently accessed data in memory to reduce latency and database load for single-machine applications.
- Key-Value Stores - Provides a simple in-memory key-value store as a lightweight alternative to external caching systems.
- RWMutex-Guarded Stores - Uses a sync.RWMutex to allow multiple readers or a single writer without race conditions.
- Cache Expiration Management - Automatically removes cached items after a configurable duration to ensure data freshness.
- Time-To-Live Expirations - Attaches a creation time and duration to each cached entry for precise expiration checks.
- Background Cleanup Intervals - Provides a background goroutine that periodically purges expired cache entries at configurable intervals.
- Cache State Persistences - Saves the in-memory cache to a file and reloads it on startup for recovery after restarts.
- Cache-to-Disk Serializations - Persists the in-memory cache to a file and reloads it on startup to recover from downtime.
- Cache State Serializations - Serializes the entire cache to a file using gob encoding for disk persistence and recovery after restarts.
- Caching Libraries - Simple in-memory KV cache.
- Databases and Storage - A simple in-memory key-value store for single-node applications.
- Key-Value Stores - In-memory key-value cache for single-machine applications.
