Skip to content

Ritsurin 0.1.0

Latest

Choose a tag to compare

@KoichiroKAMADA KoichiroKAMADA released this 09 Jul 07:38
d04a26c

Ritsurin 0.1.0 Release Notes

Ritsurin 0.1.0 is the first public release for a thin Swift 6 wrapper
around Apple Keychain Services generic password items.

Ritsurin is designed for apps that want explicit Keychain coordinates, typed
errors, migration-friendly generic-password behavior, and small convenience APIs
without adding third-party dependencies.

It is not custom cryptography, not a replacement for the system keychain, and
not a biometric, Secure Enclave, shared web credentials, or internet password
library.

Highlights

  • RKeychain synchronous API for generic password items.
  • RAsyncKeychain async/await API backed by a private serial dispatch queue.
  • Typed RKeychainError mapping for common Security framework statuses.
  • RKeychainAccessibility with .afterFirstUnlock as the default.
  • String, Data, and JSON Codable convenience APIs.
  • Migration-friendly string subscript that intentionally discards errors.
  • Missing items represented as nil; deleting missing items succeeds.
  • Query construction designed to reach existing generic-password items without
    copying or deleting them.
  • Swift Testing coverage for query construction, error mapping, behavior, async
    delegation, and Codable round trips.
  • Public documentation for usage, migration, best practices, comparison, FAQ,
    and API review.

Install

.package(url: "https://github.com/KoichiroKAMADA/Ritsurin.git", .upToNextMinor(from: "0.1.0"))

Ritsurin 0.1.0 is pre-1.0. The public API is intended to be small and practical,
but stronger source-stability expectations should wait for a future 1.0 release
line.