How do I handle data migrations with Skopelos?

Skopelos relies on Core Data's built-in migration mechanisms; you must manage model versions and lightweight migrations manually, as the library doesn't abstract this process, requiring familiarity with Core Data migration techniques.

Is Skopelos better than MagicalRecord for Core Data?

Skopelos offers a more thread-safe and minimalistic approach with explicit CQRS separation, whereas MagicalRecord has a larger ecosystem but more boilerplate. However, Skopelos has a smaller community and fewer third-party extensions.

How to use Skopelos in a SwiftUI app?

Inject Skopelos as a dependency into your ViewModels or DataControllers, then use read/write blocks to fetch and update data, ensuring UI updates are dispatched to the main thread, as Skopelos doesn't provide direct SwiftUI bindings.

Does Skopelos support batch operations for performance?

No, Skopelos focuses on basic CRUD helpers; for batch inserts or fetches, you must use Core Data's native methods within the read/write blocks, which means no abstraction over performance optimizations.

Can I test Core Data code easily with Skopelos?

Yes, by using the inMemoryStack option during testing, you can create isolated, fast tests without persisting data to disk, as shown in the instantiation examples for unit testing scenarios.

What happens if I need to access managed objects across different threads?

Skopelos enforces thread safety by requiring all accesses via read/write blocks; use SK_inContext to retrieve objects in different blocks, but misuse can still lead to issues if Core Data concurrency rules are violated.

Open-Awesome

Skopelos

MITSwift2.4.0

A minimalistic, thread-safe, non-boilerplate Swift library for Core Data, inspired by Active Record.

Visit Website GitHub

239 stars18 forks0 contributors

What is Skopelos?

Skopelos is a Swift library that provides a minimalistic, thread-safe wrapper around Core Data, inspired by the Active Record pattern. It simplifies data persistence in iOS/macOS apps by reducing boilerplate code and ensuring safe concurrent access to managed object contexts. The library implements a CQRS approach with clear separation of read and write operations.

Target Audience

iOS and macOS developers working with Core Data who want a safer, simpler alternative to raw Core Data or libraries like MagicalRecord, especially those building apps with complex data models and concurrency requirements.

Value Proposition

Developers choose Skopelos for its thread-safe design, reduced boilerplate, and explicit context management, which prevent common Core Data pitfalls. It offers a clean API with CQRS separation, automatic state handling, and no singleton dependency, making it testable and easy to integrate via dependency injection.

Overview

A minimalistic, thread safe, non-boilerplate and super easy to use version of Active Record on Core Data. Simply all you need for doing Core Data. Swift flavour.

Use Cases

Best For

Simplifying Core Data usage in Swift projects with minimal boilerplate
Ensuring thread-safe data access in multi-threaded iOS applications
Implementing a CQRS pattern for clear separation of read and write operations
Managing Core Data stacks with automatic state saving on app backgrounding
Reducing concurrency bugs in Core Data with explicit context handling
Building apps that require safe, sequential chaining of data operations

Not Ideal For

Projects heavily using Swift's modern concurrency (async/await) due to reliance on completion handlers
Teams wanting database-agnostic persistence, as Skopelos is exclusively tied to Core Data
Apps with simple data storage needs where UserDefaults or lighter solutions would suffice, avoiding Core Data overhead
Developers who prefer full, low-level control over their Core Data stack without any enforced hierarchy

Pros & Cons

Pros

Thread-Safe Guarantee

All data access is inherently thread-safe, preventing common Core Data concurrency bugs by enforcing context-per-thread patterns, as emphasized with the -com.apple.CoreData.ConcurrencyDebug flag recommendation.

CQRS Pattern Clarity

Implements Command and Query Responsibility Segregation with separate read() and writeSync()/writeAsync() methods, making data operations explicit and reducing errors, as shown in the clean API design.

Automatic State Management

Includes an AppStateReactor that silently saves in-flight changes when the app backgrounds or terminates, ensuring data persistence without manual intervention, as described in the README.

Minimal Boilerplate

Provides CRUD helper methods like SK_create and SK_all that simplify entity operations within safe read/write blocks, drastically reducing repetitive Core Data code, as demonstrated in the usage examples.

Cons

Core Data Lock-In

Skopelos is exclusively designed for Core Data, offering no flexibility for teams using or considering alternative databases like Realm or direct SQLite, which limits its applicability.

Limited Modern Concurrency

The library relies on traditional completion blocks for async operations, lacking native integration with Swift's async/await, making code less elegant in modern Swift projects compared to newer libraries.

Enforced Context Hierarchy

It imposes a specific managed object context stack with the main context as the single source of truth, which might not align with all architectural preferences or complex migration scenarios, reducing flexibility.

Open Source Alternative To

Skopelos is an open-source alternative to the following products:

MagicalRecord

MagicalRecord is a Core Data wrapper library for Objective-C and Swift that simplifies data persistence operations in iOS/macOS apps.

Frequently Asked Questions

Related Projects

MagicalRecord

Super Awesome Easy Fetching for Core Data!

Stars10,705

Forks1,765

Last commit5 years ago

CoreStore

Unleashing the real power of Core Data with the elegance and safety of Swift

Stars4,052

Forks259

Last commit19 hours ago

Mogenerator

Core Data code generation

Stars3,019

Forks385

Last commit1 year ago

Sync

JSON to SwiftData and back. SwiftData Sync.

Stars2,540