jaemk/cached - CodSpeed

cached

Blog Docs Changelog

Performance History

Latest Results

docs: rename migration files so no-suffix = agent, -human suffix = human 0.x-to-1.0-agent.md → 0.x-to-1.0.md (agent, no suffix) 0.x-to-1.0.md → 0.x-to-1.0-human.md (human, -human suffix) Update cross-links in both files and CHANGELOG.md accordingly.

20250525.sharded-cache

3 days ago

fix: address PR review feedback - Unify zero-TTL validation in ShardedTtlCacheBuilder and ShardedLruTtlCacheBuilder to use the shared validate_ttl helper, matching all other TTL builders - Add early compile-error checks for `option = true` combined with redis/disk/ty/create, replacing the delayed return-type check with targeted per-attribute errors - Document that `option = true` + `expires = true` stores the inner T of Option<T>, so T (not Option<T>) must implement Expires - Add #[inline] to ConcurrentCached default alias methods (get/set/remove/delete) - Improve SAFETY comments in TtlSortedCache to document StripedCounter aliasing invariant - Update golden test stderr for concurrent_cached_option_with_redis to match new span/message - Add ShardedTtlCache and ShardedLruTtlCache to zero-TTL unification CHANGELOG entry

20250525.sharded-cache

4 days ago

feat: add option=true support to #[concurrent_cached] and unify macro arg naming - Add `option = true` attribute to `#[concurrent_cached]`: skips caching `None` return values on the default in-memory sharded path, matching `#[cached(option=true)]` semantics. Composable with `with_cached_flag = true` for `Option<Return<T>>` return types. Restricted to infallible in-memory stores (not redis/disk/custom ty). - Add clear compile error for `Option<Return<T>>` without `option = true`, directing users to add `option = true` instead of emitting a confusing generated-code type error. - Rename `IOMacroArgs` → `ConcurrentCachedArgs` and `MacroArgs` → `CachedMacroArgs` for consistent naming across all three proc macro arg structs. - Add async `#[concurrent_cached(with_cached_flag = true)]` integration tests covering both `Result<Return<T>, E>` and plain `Return<T>` return types. - Add UI compile-fail test for `option = true` with redis (only in-memory supported) and repurpose the existing option-unsupported test to cover non-Option return type. - Update docs, CHANGELOG, and README to accurately reflect `option` as a supported `#[concurrent_cached]` attribute (not a rejected `#[cached]`-only attribute).

20250525.sharded-cache

5 days ago

fix: with_cached_flag error message, ShardedTtlCache build panic, evictions guard - Update #[concurrent_cached(with_cached_flag=true)] error message to list cached::Return<T> as a supported return type alongside Result<cached::Return<T>, E>. The plain-return form was added in a previous commit but the error message wasn't updated. - Extend ShardedTtlCache::build() panic messages to include the underlying BuildError detail via unwrap_or_else(|e| panic\!("...{e}")) matching the pattern already applied to the five other sharded stores. - Guard evictions counter increment in ShardedExpiringLruCache::cache_get inside if-let-Some to match the pattern used in cache_remove and avoid misleading code structure (unconditional increment before the guard). - Update trybuild golden file for concurrent_cached_with_cached_flag_foreign to include the new cached::Return<T> line in the error output.

20250525.sharded-cache

5 days ago

ci: restore CodSpeed simulation mode

20250525.sharded-cache

5 days ago

fix: address PR review feedback

20250525.sharded-cache

5 days ago

fix: LruCache::retain fires on_evict; ShardedLruTtlCache::evict no longer double-counts - Public LruCache::retain now calls cache_remove (fires on_evict, increments evictions) matching cache_remove semantics. Internal TTL/ expiring wrapper stores switch to a new pub(super) retain_silent for their eviction sweeps to avoid double-counting. - Fix ShardedLruTtlCacheBase::evict() to use cache_remove_entry instead of cache_remove when removing expired per-shard entries. Previously cache_remove incremented the inner LruCache shard eviction counter and fired the wrapped on_evict closure, while the outer evict() also incremented ttl_evictions and fired on_evict — causing metrics(). evictions to be double the actual count and on_evict to fire twice per expired entry. The fix uses cache_remove_entry (side-effect-free) in the shard loop so the outer evict() remains the single accounting site. - Add tests: lru_retain_fires_on_evict_and_increments_evictions, test_lru_ttl_evict_does_not_double_count_evictions, sharded_lru_ttl_evict_does_not_double_count_evictions_or_double_fire_on_evict

20250525.sharded-cache

5 days ago

fix: address PR review feedback — clone removal, doc clarifications, test improvements - Remove redundant `.clone()` on `#[concurrent_cached]` cache-hit return path for all three variants (with_cached_flag, Result<T,E>, plain T): the value from cache_get is already owned, so cloning before returning was wasted work on every cache hit - Extend build() panic messages on ShardedLruCache, ShardedExpiringLruCache, and ShardedLruTtlCache to include BuildError detail (previously only the with_size_* convenience constructors had detailed panic messages) - Correct FibHasher example doc: describes Fibonacci hashing, not upper-byte partitioning - Add no-op note to set_refresh_on_hit on ShardedLruCache, ShardedExpiringCache, and ShardedExpiringLruCache (these stores have no refreshable TTL) - Document that cache_set on expiring stores returns the raw stored value without checking is_expired; add note to behavioral guarantees that sharded stores do not implement CachedIter or CachedPeek - Clarify copy_from LRU ordering: per-shard ordering is preserved but global recency rank is not guaranteed after resharding - Clarify ttl_nanos field comment: 0 is only reachable via unset_ttl(), not at build time - Add call-count assertion to plain_option_return_caches_none_and_some test to verify None and Some values are actually cached - Regenerate README from lib.rs

20250525.sharded-cache

5 days ago

Latest Branches

-43%

feat: sharded in-memory stores + #[concurrent_cached] default#264

3 days ago

ce4274c

20250525.sharded-cache

+14%

feat: expiring ttl cache#263

12 days ago

d9b5feb

260522.expires-ttl-once

N/A

Add CodSpeed performance benchmarks for cache stores#262

12 days ago

4c0e8fd

codspeed-wizard-1779471234220

© 2026 CodSpeed Technology

Home Terms Privacy Docs