Yashima 1.0.0 Release Notes
Yashima 1.0.0 is the first stable API release of the Swift Concurrency-first
local artifact cache.
Yashima is designed for generated app artifacts that are expensive to recreate
but safe to delete: thumbnails, previews, map snapshots, charts, summaries,
waveforms, rendered document artifacts, and small derived metadata. It is not an
image downloader and not a database.
Highlights
- Small async get-or-generate API centered on
YCache. - Typed codecs for
Data, LZFSE-compressedData,Codable, PNG, and JPEG. - Memory and file-backed storage with configurable budgets.
- Cache identity based on both
CacheKeyandCacheCodec.identifier. - Single-flight generation for concurrent misses.
- UI lifecycle cancellation preset for SwiftUI list/grid style workloads.
- Optional generation that shares work but does not persist
nil. - Corruption-as-miss behavior for disposable cache entries.
- DocC documentation, examples, benchmark harness, comparison guide, FAQ,
practical recipes, and public contribution/security guidance.
Install
.package(
url: "https://github.com/KoichiroKAMADA/Yashima.git",
.upToNextMajor(from: "1.0.0")
)Yashima 1.0.0 is API-stable for the current generated-artifact cache surface.
Future releases may add focused convenience APIs, but the existing key, codec,
single-flight, and lifecycle semantics are intended to remain source-stable
through the 1.x line.