v0.22.1

[MrCroxx]

2026-01-11

Release

crate	version
foyer	0.22.1
foyer-tokio	0.22.1
foyer-common	0.22.1
foyer-memory	0.22.1
foyer-storage	0.22.1
foyer-bench	0.22.1

Note

foyer v0.22.0 was yanked due to an incorrect publish.

Changes

Important

Breaking 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

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

New Contributors

• @DenisGorbachev made their first contribution in chore: fix a typo in README #1175
• @jayvdb made their first contribution in docs(storage): Add Raw safety note #1227

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

---

This discussion was created from the release v0.22.1.