ReadMachine
A local-first reading library for macOS, built around your own files.
Posts
- SwiftUI Introspect: Finding Views Without Private APIs
How SwiftUI Introspect finds the right UIKit or AppKit view with paired markers, bounded traversal, and explicit OS version rules.
- Optional Chaining: Let Absence Flow Through an Expression
Follow optional values through Swift properties, calls, and subscripts—and learn what optional chaining skips, returns, and cannot protect.
- swift-async-algorithms: Backpressure at the Handoff
How AsyncChannel makes Swift producers wait for demand, handles cancellation races, and differs from buffered streams.
- GRDB at the Boundary Between Files and App State
Why ReadMachine keeps documents on disk, uses GRDB for durable app state, and treats SQLite transactions and file operations differently.
- swift-format: From Syntax Trees to Readable Code
Why swift-format needs syntax trees, rewriting rules, and a pretty printer, and why linting takes a different path.
- Optional Binding: Turn an Optional Into a Value
Learn how Swift optional binding creates safe local values, combines checks, and controls where unwrapped values are available.
- Swift Argument Parser: One Model for CLI Commands
A source-level look at how Swift Argument Parser turns property wrappers and command types into parsing rules, validation, usage, and help.
- File Identity Is Not Content Identity: How ReadMachine Uses BLAKE3
ReadMachine separates filesystem reconciliation, document preparation, and content fingerprinting so each stage solves a different problem.
- guard: Keep the Main Path Flat
Use Swift guard to state requirements early, keep successful optional bindings in scope, and leave the main path easy to follow.
- Nuke: Coalescing Image Work Across Swift Concurrency
A source-level look at how Nuke shares downloads, decoding, and image processing across concurrent requests without tying cancellation to a single caller.