v0.22.1

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 #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