foyer-common

2026-01-23

Release

Changes

• Fix: Fix false positive hybrid cache miss metrics with HybridCache::get_or_fetch() API call.

Full Changelog: v0.22.2...v0.22.3

2026-01-12

Release

Changes

• Unpin hashbrown version.

What's Changed

• chore: release foyer v0.22.2 by @MrCroxx in #1254
• build: fine tune dependencies by @tisonkun in #1252

Full Changelog: v0.22.1...v0.22.2

2026-01-11

Release

Changes

Changes:

• Remove .with_runtime_options() and RuntimeOptions from the disk cache build. Use .with_spawner() and Spawner instead. At the same time, simplified the Runtime options that are no longer needed. #1229
• Align io engine and engine config naming. All items that need to be built by the user are named ..Builder, and all items built by foyer are named ..Config. #1232
• Support get memory entry count via API and metrics.
• Fix LRU high priority weight calculation.
• Update dependencies. Drop madsim dependency when it is not needed.

What's Changed

• chore: use mea primitives over tokio::sync by @tisonkun in #1209
• chore: fix changelog v0.21.0 release date by @MrCroxx in #1213
• chore: impl From<std::io::Error> for foyer::Error by @shikhar in #1215
• refactor: impl From for bincode error by @MrCroxx in #1216
• chore: update changelog, bump version by @MrCroxx in #1219
• chore: remove some stale codes, pin hashbrown version by @MrCroxx in #1222
• chore: fix a typo in README by @DenisGorbachev in #1175
• chore: remove unused codes by @MrCroxx in #1225
• docs(storage): Add Raw safety note by @jayvdb in #1227
• chore: adapt to the latest fastrace by @MrCroxx in #1230
• refactor: introduce Spawner and foyer-tokio crate by @MrCroxx in #1229
• chore: do not run pages actions on fork by @yihong0618 in #1228
• chore: drop two unused dependiences by @yihong0618 in #1231
• refactor: align io engine and engine config naming by @MrCroxx in #1232
• chore: use jiff over chrono by @tisonkun in #1233
• chore: update license header by @MrCroxx in #1236
• chore: upgrade to mea 0.6.0 by @tisonkun in #1235
• fix: fix LRU high priority weight calculation by @yihong0618 in #1238
• feat: support get mem cache entry count via API and metrics by @MrCroxx in #1241
• perf: improve recovery performance by @leiysky in #1243
• refactor: try reduce arc-swap by @tisonkun in #1245
• fix: fix feature passing among crates for publishing by @MrCroxx in #1246
• chore: release foyer v0.22.1 by @MrCroxx in #1247

New Contributors

• @DenisGorbachev made their first contribution in #1175
• @jayvdb made their first contribution in #1227

Full Changelog: v0.21.1...v0.22.1

2026-01-23

Release

Changes

• Fix: Fix false positive hybrid cache miss metrics with HybridCache::get_or_fetch() API call.

Full Changelog: v0.22.1...v0.21.2

2025-12-12

Release

Changes

• Implement From<std::io::Error> and From<bincode::Error> (if feature serde is enabled) for Error to simplify error handling.

What's Changed

• chore: fix changelog v0.21.0 release date (#1213) by @MrCroxx in #1214
• refactor: impl from std::io::Error bincode::Errorfor Error by @MrCroxx in #1217
• chore: release foyer v0.21.1 by @MrCroxx in #1218

Full Changelog: v0.21.0...v0.21.1

Changes

Features and Enhances:

• Refine hybrid cache read-related APIS.
  • New get() API: Replace the old obtain() API, support memory and disk cache read, request deduplication, and other optimizations. (The old get() API without disk cache request deduplication is deprecated.)
  • New get_or_fetch() API: Replace the old fetch() API, support memory and disk cache read, automatic cache refill on cache miss, request duduplication, and other optimizations.
  • Fix panics with race condition while using both get() (previously obtain()) and get_or_fetch() (previously fetch()) on the same key.
  • Refine error and result type with get_or_fetch() API.
• Refine Source and Age preprotities. Now, Source refer to where the entry comes from, e.g. memory cache, disk cache, or outer; Age refer to the generation the entry is in the disk cache.
• Refine Error type. Use OpenDAL-like error definition.
• Auto implement Code for bytes::Bytes without serde feature.
• Reduce task spawning on recovery.

Bug Fixes:

• Fix panics when cancelling spawned fetch requests.
• Fix string trimming when parsing io throttle.
• Fix build on x86 targets.

Testing:

• Support simulating io latency with psync io engine in foyer-bench.
• Refine hybrid cache fuzzy test.

What's Changed

• build: refine ci triggers by @MrCroxx in #1151
• fix: fix enabling dev-dependencies features with the same crate by @MrCroxx in #1154
• chore: bump main branch to v0.21.0-dev, fulfill changelogs by @MrCroxx in #1156
• test: introduce simulated io latency for psync engine by @MrCroxx in #1159
• chore: bump deps by @MrCroxx in #1160
• test: separate read and fetch in hybrid cache fuzzy test by @MrCroxx in #1161
• fix: removed unnecessary constraints to allow use of non-static keys by @rrauch in #1163
• chore: fix typos by @MrCroxx in #1165
• fix: fix issue with untrimmed string while parsing throttle by @vadim2404 in #1164
• fix: preserve raw cache capacity across shards by @Xuanwo in #1167
• fix: fix disk op duration metrics by @MrCroxx in #1169
• chore: bump changelog by @MrCroxx in #1172
• chore: reduce task spawning during recovery by @leiysky in #1174
• refactor: refine read-related APIs to fix panics and refine APIs by @MrCroxx in #1177
• docs: update docs for foyer v0.20 by @MrCroxx in #1179
• fix: fix foyer build with nightly toolchain by @MrCroxx in #1180
• fix: restore default random state for hybrid get and fetch by @MrCroxx in #1181
• feat: expose fetch state and role by @MrCroxx in #1182
• refactor: use foyer defined result for memory get_or_fetch by @MrCroxx in #1184
• refactor: use foyer defined result type for memory get_or_fetch() by @MrCroxx in #1185
• refactor: refine properties, remove source, refine age by @MrCroxx in #1186
• feat: support entry source (outer/memory/disk), refine test utils by @MrCroxx in #1187
• refactor: expose entry source by @MrCroxx in #1188
• fix: spawn fetch task to prevent from leader cancel by @MrCroxx in #1189
• docs: refine foyer crate rustdoc, use filtered readme by @MrCroxx in #1191
• feat: impl Code for bytes::Bytes by @tisonkun in #1195
• perf: split encode/decode bench w/wo serde feature by @MrCroxx in #1196
• fix: fastant cannot build on x86 by @tisonkun in #1197
• ci: run test with single worker and deadlock detection by @MrCroxx in #1199
• refactor: loose get_or_fetch() closure trait bounds by @MrCroxx in #1203
• refactor: refine error design by @MrCroxx in #1205
• refactor: refine get_or_fetch closure args by @MrCroxx in #1206
• refactor: refine Error and doc for Code trait impl by @MrCroxx in #1208
• chore: release foyer v0.21.0 by @MrCroxx in #1207

New Contributors

• @rrauch made their first contribution in #1163
• @vadim2404 made their first contribution in #1164
• @leiysky made their first contribution in #1174

Full Changelog: v0.20.1...v0.21.0

Release

Changes

• Fix metrics "Disk Op Duration".

What's Changed

• fix: fix disk op duration metrics (#1169) by @MrCroxx in #1170
• chore: release foyer v0.20.1 by @MrCroxx in #1171

Full Changelog: v0.20.0...v0.20.1

2025-09-23

Release

Changes

• Fix race condition (panic / deadlock) when there are concurrent disk cache write operations and fetch operations on the same key.
• Fix heap-use-after-free on dropping foyer cache / hybrid cache while there are still ongoing disk IOs.
• Remove property ephemeral.

What's Changed

• chore: cherry-pick changelog of v0.19.0, bump main version by @MrCroxx in #1102
• chore: update changelog for v0.18.1 by @MrCroxx in #1106
• feat: support serde for properties by @MrCroxx in #1108
• chore: fulfill changelog by @MrCroxx in #1112
• docs: move website repo to subdir in this repo by @MrCroxx in #1124
• fix: fix website base url by @MrCroxx in #1125
• fix: fix foyer website logo by @MrCroxx in #1126
• docs: fix license check badge by @MrCroxx in #1130
• fix: fix ephemeral entry becomes ephemeral after access by @MrCroxx in #1123
• docs: update arch docs by @MrCroxx in #1132
• chore: update npm dependencies version by @MrCroxx in #1133
• docs: continue updating arch docs by @MrCroxx in #1134
• docs: update arch docs by @MrCroxx in #1135
• docs: update case study - RisingWave by @MrCroxx in #1136
• docs: update case study - RisingWave by @MrCroxx in #1137
• fix: HUAF in PsyncIoEngine during task cancellation by @Copilot in #1140
• docs: add arch and case study docs link in readme by @MrCroxx in #1146
• fix: fix issue 1121 panics on concurrent disk cache write & fetch by @MrCroxx in #1147
• refactor: restore raw waiter with std hashmap by @MrCroxx in #1148
• build: refine ci triggers (#1151) by @MrCroxx in #1152
• fix: fix enabling dev-dependencies features (#1154) by @MrCroxx in #1155
• chore: release foyer v0.20.0 by @MrCroxx in #1150

New Contributors

• @Copilot made their first contribution in #1140

Full Changelog: v0.19.2...v0.20.0

Releases

Changes

• Fix: Fix hybrid cache in-memory compatible mode conditional statement without io_engine specified.

What's Changed

• fix: fix is_noop() logic in store.rs (#1113) by @MrCroxx in #1114
• chore: release foyer v0.19.2 by @MrCroxx in #1115

Full Changelog: v0.19.1...v0.19.2

Releases

Changes

• Feature: Support serde for properties.

What's Changed

• feat: support serde for properties (#1108) by @MrCroxx in #1109
• chore: release foyer v0.19.1 by @MrCroxx in #1110

Full Changelog: v0.19.0...v0.19.1