Skip to content

Commit 4a00211

Browse files
committed
Release v0.2.0-alpha
Bump version to 0.2.0-alpha and update changelog with new features: S3-FIFO, Clock-PRO, Clock cache policies, FastLru, 2Q eviction policy, human-readable benchmark reports, and new workload generators.
1 parent 1acd6e5 commit 4a00211

3 files changed

Lines changed: 7 additions & 3 deletions

File tree

CHANGELOG.md

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ All notable changes to cachekit will be documented in this file.
55
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
66
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
77

8-
## [Unreleased]
8+
## [0.2.0-alpha] - 2026-01-19
99

1010
### Added
1111
- S3-FIFO cache policy (`S3FifoCache`) implementing the scan-resistant FIFO variant with small/main/ghost queues.
@@ -14,6 +14,9 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
1414
- `FastLru` policy for single-threaded performance with cache-line optimized layout and direct value storage.
1515
- S3-FIFO benchmarks (`benches/s3_fifo.rs`) with workload generators.
1616
- Comparison benchmarks (`benches/comparison.rs`) for evaluating cache policies against external libraries (moka, quick_cache).
17+
- Human-readable benchmark reports (`benches/reports.rs`) for cache policy comparison tables without criterion overhead.
18+
- New workload generators for benchmarking: `ScrambledZipfian`, `Latest`, `ShiftingHotspot`, `Exponential`.
19+
- `rand` and `rand_distr` dependencies for workload simulation.
1720
- Unified cache builder (`CacheBuilder`) with support for all eviction policies (FIFO, LRU, LRU-K, LFU, HeapLFU, 2Q).
1821
- New 2Q eviction policy (`TwoQCore`) with configurable probation/protected queue ratios.
1922
- Example programs: `basic_s3_fifo.rs` for S3-FIFO cache policy, `basic_two_q.rs` for 2Q cache policy, `basic_builder.rs` for CacheBuilder API usage.
@@ -26,6 +29,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
2629
### Documentation
2730
- S3-FIFO cache policy documentation (`docs/policies/s3-fifo.md`) with architecture, queue management, and ghost filtering.
2831
- Clock policy documentation moved from roadmap to main policies (`docs/policies/clock.md`).
32+
- Benchmark README enhanced with detailed performance insights, hit rate comparisons, and policy selection guide.
2933
- 2Q cache policy documentation (`docs/policies/2q.md`) with goals, data structures, operations, and complexity analysis.
3034
- README enhanced with Quick Start section and examples for all eviction policies.
3135
- Complete documentation for `src/policy/lru_k.rs`:

Cargo.lock

Lines changed: 1 addition & 1 deletion
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

Cargo.toml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
[package]
22
name = "cachekit"
3-
version = "0.1.0-alpha"
3+
version = "0.2.0-alpha"
44
edition = "2024"
55
rust-version = "1.85"
66
authors = ["Thomas Korrison <ferrite.db@gmail.com>"]

0 commit comments

Comments
 (0)